How yasir2000/proof-mcp works
Proof-MCP is a local CLI and stdio MCP server for code-verification workflows. Developers or agents request source context or QA discovery, then submit candidate Lean/TLA+ artifacts or select checks; the server dispatches them to external checkers and returns bounded evidence. Configured workspace verification, approval-gated QA commands, Clarity context, and source preparation are distinct capabilities. Edges below follow the shown entry-point dispatch and sampled module calls; README-documented but unsampled agent skills are represented without speculative implementation links.
Main entry points: runner.ts Checker execution · index.ts CLI and MCP entry · config.ts Workspace config · context.ts Source preparation
Components 16
CLI and MCP
- CLI and MCP entry
src/index.ts - Workspace config
src/config.ts
Workspace Context
- Source preparation
src/context.ts
Verification
- Configured verification
src/workspace.ts - Generated artifact checks
src/generated.ts - Checker execution
src/runner.ts
QA Planning
- QA discovery and approval
src/qa.ts
Other components
- Developer or agent
- Lean 4
- TLC model checker
- Python runtime
- Clarity CLI
- Approved project commands
- Agent specification skills
.github/skills - Selected source and tests
- Temporary or retained artifacts
Connections 21
- Developer or agent → CLI and MCP entry: requests checks
README.md - Agent specification skills → Developer or agent: guides generation
README.md - CLI and MCP entry → Workspace config: resolves workspace
src/index.ts - CLI and MCP entry → Source preparation: prepares context
src/index.ts - Source preparation → Workspace config: resolves paths
src/context.ts - Source preparation → Selected source and tests: reads selected files
src/context.ts - Source preparation → Checker execution: requests Clarity context
src/context.ts - CLI and MCP entry → QA discovery and approval: discovers or runs QA
src/index.ts - QA discovery and approval → Workspace config: reads optional config
src/qa.ts - QA discovery and approval → Approved project commands: runs approved commands
src/qa.ts - CLI and MCP entry → Configured verification: verifies configured workspace
src/index.ts - Configured verification → Workspace config: reads manifest
src/workspace.ts - Configured verification → Checker execution: dispatches checks
src/workspace.ts - CLI and MCP entry → Generated artifact checks: checks generated artifacts
src/index.ts - Generated artifact checks → Workspace config: validates workspace paths
src/generated.ts - Generated artifact checks → Temporary or retained artifacts: writes temporary artifacts
src/generated.ts - Generated artifact checks → Checker execution: checks generated files
src/generated.ts - Checker execution → Lean 4: runs Lean
src/runner.ts - Checker execution → TLC model checker: runs TLC
src/runner.ts - Checker execution → Python runtime: runs test file
src/runner.ts - Checker execution → Clarity CLI: runs analysis
src/runner.ts