How balanov/mcp-attest works
mcp-attest is a policy-as-code conformance and attestation harness for live MCP servers. The main workflow starts at the CLI: load a policy and target, run identity-specific real calls, compare observed behavior with expected decisions, then report findings and evidence. Separate capabilities cover OAuth probes, portable suites, offline trace checks and shadow-path detection, posture assessment, and OTLP trace export. Relationships below use README statements and the source index/import references; unsampled implementation details are not inferred.
Main entry points: cli.py CLI · conformance.py Conformance runner · checks.py Trace checks · policy.py Policy model
Components 19
Test workflow
- CLI
src/mcp_attest/cli.py - Policy model
src/mcp_attest/policy.py - Target config
src/mcp_attest/targets.py - Conformance runner
src/mcp_attest/conformance.py
MCP and OAuth
- MCP client
src/mcp_attest/client.py - JSON-RPC
src/mcp_attest/jsonrpc.py - OAuth probes
src/mcp_attest/oauth.py
Trace analysis
- Trace checks
src/mcp_attest/checks.py - Trace model
src/mcp_attest/trace.py - Shadow paths
src/mcp_attest/shadow.py - Posture assessment
src/mcp_attest/posture.py - OTLP export
src/mcp_attest/otlp.py
Evidence and rules
- Rule catalog
src/mcp_attest/rules.py - Evidence bundles
src/mcp_attest/evidence.py - Call receipts
src/mcp_attest/receipts.py - Findings report
src/mcp_attest/report.py
Suites and posture
- Conformance suites
src/mcp_attest/suite.py
Other components
- Harness user
- MCP server
Connections 26
- Harness user → CLI: runs commands
README.md - CLI → Policy model: loads policy
src/mcp_attest/cli.py - CLI → Target config: parses target
src/mcp_attest/cli.py - CLI → Conformance runner: starts tests
src/mcp_attest/cli.py - Conformance runner → MCP client: sends calls
src/mcp_attest/conformance.py - MCP client → JSON-RPC: encodes messages
src/mcp_attest/client.py - MCP client → MCP server: connects to
README.md - Conformance runner → Policy model: compares decisions
src/mcp_attest/conformance.py - Conformance runner → OAuth probes: runs probes
src/mcp_attest/conformance.py - CLI → Trace checks: runs checks
src/mcp_attest/cli.py - Trace checks → Trace model: inspects events
src/mcp_attest/checks.py - Trace checks → Policy model: checks policy
src/mcp_attest/checks.py - Trace checks → Rule catalog: uses rule IDs
src/mcp_attest/checks.py - CLI → Trace model: loads traces
src/mcp_attest/cli.py - CLI → Shadow paths: finds bypasses
src/mcp_attest/cli.py - Shadow paths → Trace model: reads routes
src/mcp_attest/shadow.py - CLI → Posture assessment: assesses posture
src/mcp_attest/cli.py - CLI → OTLP export: exports traces
src/mcp_attest/cli.py - OTLP export → Trace model: uses trace data
src/mcp_attest/otlp.py - CLI → Conformance suites: runs suites
src/mcp_attest/cli.py - Conformance suites → Policy model: creates policy
src/mcp_attest/suite.py - CLI → Evidence bundles: builds bundles
src/mcp_attest/cli.py - Evidence bundles → Call receipts: uses receipts
src/mcp_attest/evidence.py - CLI → Findings report: formats findings
src/mcp_attest/cli.py - Findings report → Trace checks: renders results
src/mcp_attest/report.py - Findings report → Conformance runner: renders results
src/mcp_attest/report.py