Directories
¶
| Path | Synopsis |
|---|---|
|
agentloop.go — Spec 103 US2: the LIVE agent-loop driver.
|
agentloop.go — Spec 103 US2: the LIVE agent-loop driver. |
|
arms
Package arms implements the encoding arms of the discovery-effectiveness profiler (spec 083).
|
Package arms implements the encoding arms of the discovery-effectiveness profiler (spec 083). |
|
cmd/bench
command
Command bench runs the mcpproxy benchmark.
|
Command bench runs the mcpproxy benchmark. |
|
cmd/breakevencurve
command
Command breakevencurve computes the fleet-size break-even curve: at how many upstream tools (and servers) does the proxy stop costing more than it saves?
|
Command breakevencurve computes the fleet-size break-even curve: at how many upstream tools (and servers) does the proxy stop costing more than it saves? |
|
cmd/codeexecsaving
command
Command codeexecsaving reports the RESPONSE-SIDE saving of code execution from a recorded activity export: what the sandbox's sub-call responses would have cost an agent that made those calls itself, against the script it sent and the single result it got back.
|
Command codeexecsaving reports the RESPONSE-SIDE saving of code execution from a recorded activity export: what the sandbox's sub-call responses would have cost an agent that made those calls itself, against the script it sent and the single result it got back. |
|
cmd/iosplit
command
Command iosplit reports code execution's cost split by BILLING DIRECTION.
|
Command iosplit reports code execution's cost split by BILLING DIRECTION. |
|
cmd/warmtiktoken
command
Command warmtiktoken populates the tiktoken vocabulary cache before a parallel test run.
|
Command warmtiktoken populates the tiktoken vocabulary cache before a parallel test run. |
|
corpusio
Package corpusio loads public tool-retrieval corpora into the bench types (spec 083, US3).
|
Package corpusio loads public tool-retrieval corpora into the bench types (spec 083, US3). |
|
replaycorpus
codeexec.go — the response-side saving of code execution.
|
codeexec.go — the response-side saving of code execution. |
|
cmd
|
|
|
generate-types
command
Package main generates TypeScript types from Go contracts
|
Package main generates TypeScript types from Go contracts |
|
mcpfixture
command
Command mcpfixture is a deterministic MCP upstream fixture for the release QA gate (Spec 081, FR-006/FR-007).
|
Command mcpfixture is a deterministic MCP upstream fixture for the release QA gate (Spec 081, FR-006/FR-007). |
|
mcpproxy
command
doctor_fix_cmd.go implements `mcpproxy doctor fix <CODE> --server <name>` (spec 044).
|
doctor_fix_cmd.go implements `mcpproxy doctor fix <CODE> --server <name>` (spec 044). |
|
mcpproxy-tray
command
|
|
|
oas-nullable
command
Command oas-nullable post-processes the swag-generated OpenAPI 3.1 artifacts (oas/swagger.yaml and oas/docs.go).
|
Command oas-nullable post-processes the swag-generated OpenAPI 3.1 artifacts (oas/swagger.yaml and oas/docs.go). |
|
populate-test-data
command
|
|
|
qapilot
command
Command qapilot is the quarantine/approval testing pilot's CI driver.
|
Command qapilot is the quarantine/approval testing pilot's CI driver. |
|
release-gate
command
Command release-gate is the Spec 081 release-qualification gate driver.
|
Command release-gate is the Spec 081 release-qualification gate driver. |
|
scan-eval
command
Command scan-eval bridges the Spec 065 / D2 security corpus to mcpproxy's production sensitive-data detector and emits per-entry, per-detector verdict JSON for the Python SecurityScorer (B3).
|
Command scan-eval bridges the Spec 065 / D2 security corpus to mcpproxy's production sensitive-data detector and emits per-entry, per-detector verdict JSON for the Python SecurityScorer (B3). |
|
scope-latency-compare
command
Command scope-latency-compare is the T112a merge-base gate for Spec 105 FR-011: it compares the administrator p95 latency for each of the four scope-hardening operations (retrieve_tools, read_cache, prompts/list, tools/list) between two revisions and fails if HEAD regressed by more than max(10%, 5ms) on any operation, or if either side is missing a measurement for any operation.
|
Command scope-latency-compare is the T112a merge-base gate for Spec 105 FR-011: it compares the administrator p95 latency for each of the four scope-hardening operations (retrieve_tools, read_cache, prompts/list, tools/list) between two revisions and fails if HEAD regressed by more than max(10%, 5ms) on any operation, or if either side is missing a measurement for any operation. |
|
skillsfixture
command
Command skillsfixture serves a fake upstream MCP server with three skills so the Skills tab of the Web UI can be exercised against a real core (spec 125, docs/development/web-ui-verification.md).
|
Command skillsfixture serves a fake upstream MCP server with three skills so the Skills tab of the Web UI can be exercised against a real core (spec 125, docs/development/web-ui-verification.md). |
|
tpa-corpus
command
Command tpa-corpus builds, verifies and validates the embedded TPA signature bundle (spec 101 US2).
|
Command tpa-corpus builds, verifies and validates the embedded TPA signature bundle (spec 101 US2). |
|
tpa-db
command
Command tpa-db is the operator tool for Spec 101 signed TPA bundles.
|
Command tpa-db is the operator tool for Spec 101 signed TPA bundles. |
|
tpa-redteam
command
Command tpa-redteam is an adversarial evasion harness for mcpproxy's TPA detection engine.
|
Command tpa-redteam is an adversarial evasion harness for mcpproxy's TPA detection engine. |
|
e2e
|
|
|
stubs/outputschema
command
Command outputschema is a minimal stdio MCP server used by the Spec 056 output-schema-validation E2E test.
|
Command outputschema is a minimal stdio MCP server used by the Spec 056 output-schema-validation E2E test. |
|
stubs/saniclient
command
Command saniclient is a tiny MCP client used by the Spec 054 Track B verification: it connects to a running mcpproxy /mcp endpoint, calls call_tool_read for a given "server:tool", and prints the returned text so the harness can assert spotlighting / redaction / block behaviour.
|
Command saniclient is a tiny MCP client used by the Spec 054 Track B verification: it connects to a running mcpproxy /mcp endpoint, calls call_tool_read for a given "server:tool", and prints the returned text so the harness can assert spotlighting / redaction / block behaviour. |
|
stubs/sanitisation
command
Command sanitisation is a minimal stdio MCP server used by the Spec 054 Track B output-sanitisation E2E verification.
|
Command sanitisation is a minimal stdio MCP server used by the Spec 054 Track B output-sanitisation E2E verification. |
|
internal
|
|
|
audit
Package audit builds and writes the Spec 107 audit trail: one JSON line per pre-dispatch authorization decision (authz), one per completed tool dispatch (tool_call), and one per terminal login/logout attempt (auth_event).
|
Package audit builds and writes the Spec 107 audit trail: one JSON line per pre-dispatch authorization decision (authz), one per completed tool dispatch (tool_call), and one per terminal login/logout attempt (auth_event). |
|
auth
Package auth provides agent token authentication for MCPProxy.
|
Package auth provides agent token authentication for MCPProxy. |
|
branding
Package branding holds the canonical, user-facing project identifiers and URLs (homepage, repo, docs, issues) so every surface that points a user back to the project — CLI --version/--help, the MCP serverInfo instructions, docs links in errors — uses one source of truth.
|
Package branding holds the canonical, user-facing project identifiers and URLs (homepage, repo, docs, issues) so every surface that points a user back to the project — CLI --version/--help, the MCP serverInfo instructions, docs links in errors — uses one source of truth. |
|
callerr
Package callerr classifies the outcome of one upstream tool call into the call-error taxonomy of Spec 113-c: an error_class (what failed), a fault_domain (whose fault it is) and, when known, the upstream HTTP status.
|
Package callerr classifies the outcome of one upstream tool call into the call-error taxonomy of Spec 113-c: an error_class (what failed), a fault_domain (whose fault it is) and, when known, the upstream HTTP status. |
|
cli/output
Package output provides unified output formatting for CLI commands.
|
Package output provides unified output formatting for CLI commands. |
|
clientidentity
Package clientidentity derives the safe, stable identity used for untrusted MCP clientInfo names across persisted presence and session rows.
|
Package clientidentity derives the safe, stable identity used for untrusted MCP clientInfo names across persisted presence and session rows. |
|
codescripts
Package codescripts resolves and lists server-side stored scripts for the code_execution tool (Spec 097).
|
Package codescripts resolves and lists server-side stored scripts for the code_execution tool (Spec 097). |
|
commitview
Package commitview holds the value types that describe one committed view of a server (Spec 116).
|
Package commitview holds the value types that describe one committed view of a server (Spec 116). |
|
config
Package config provides configuration types and merge utilities for MCPProxy.
|
Package config provides configuration types and merge utilities for MCPProxy. |
|
configimport
Package configimport provides functionality to import MCP server configurations from external tools like Claude Desktop, Claude Code, Cursor IDE, Codex CLI, and Gemini CLI.
|
Package configimport provides functionality to import MCP server configurations from external tools like Claude Desktop, Claude Code, Cursor IDE, Codex CLI, and Gemini CLI. |
|
connect
Package connect provides functionality to register MCPProxy as an MCP server in various client configuration files (Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini, ZCode).
|
Package connect provides functionality to register MCPProxy as an MCP server in various client configuration files (Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini, ZCode). |
|
contracts
Package contracts defines typed data transfer objects for API communication
|
Package contracts defines typed data transfer objects for API communication |
|
diagnostics
Package diagnostics implements the stable error-code catalog used by mcpproxy to surface human-readable, fixable failure states to the user.
|
Package diagnostics implements the stable error-code catalog used by mcpproxy to surface human-readable, fixable failure states to the user. |
|
diagnostics/hints
Package hints builds diagnostics.ClassifierHints from configuration.
|
Package hints builds diagnostics.ClassifierHints from configuration. |
|
dockernaming
Package dockernaming centralises the rule for turning an MCPProxy server name into the sanitized token used inside a Docker container name (mcpproxy-<sanitized>-<suffix>).
|
Package dockernaming centralises the rule for turning an MCPProxy server name into the sanitized token used inside a Docker container name (mcpproxy-<sanitized>-<suffix>). |
|
gatereport
Package gatereport defines the release-qa-gate report schema (Spec 081 FR-004/FR-010) and the merger that combines per-check JSON fragments into the single gate-report.json verdict artifact plus a human-readable summary.
|
Package gatereport defines the release-qa-gate report schema (Spec 081 FR-004/FR-010) and the merger that combines per-check JSON fragments into the single gate-report.json verdict artifact plus a human-readable summary. |
|
headerfwd
Package headerfwd implements Spec 112 client header forwarding: capturing an allowlisted subset of the inbound MCP client HTTP headers into an immutable, value-redacting Snapshot, filtering it per upstream server, and exposing the result to the streamable-HTTP transport header func.
|
Package headerfwd implements Spec 112 client header forwarding: capturing an allowlisted subset of the inbound MCP client HTTP headers into an immutable, value-redacting Snapshot, filtering it per upstream server, and exposing the result to the streamable-HTTP transport header func. |
|
health
Package health provides unified health status calculation for upstream MCP servers.
|
Package health provides unified health status calculation for upstream MCP servers. |
|
httpapi
Package httpapi — diagnostics fix endpoint (spec 044).
|
Package httpapi — diagnostics fix endpoint (spec 044). |
|
httpx
Package httpx holds HTTP primitives shared by the MCP surface (internal/server) and the REST/SSE surface (internal/httpapi).
|
Package httpx holds HTTP primitives shared by the MCP surface (internal/server) and the REST/SSE surface (internal/httpapi). |
|
launch
Package launch exposes the core process's durable launch provenance: which component started this mcpproxy core (Spec 092 FR-001a).
|
Package launch exposes the core process's durable launch provenance: which component started this mcpproxy core (Spec 092 FR-001a). |
|
management
Package management provides unified server lifecycle and diagnostic operations.
|
Package management provides unified server lifecycle and diagnostic operations. |
|
oauth
Package oauth provides OAuth 2.1 authentication support for MCP servers.
|
Package oauth provides OAuth 2.1 authentication support for MCP servers. |
|
observability
Package observability provides health checks, metrics, and tracing capabilities
|
Package observability provides health checks, metrics, and tracing capabilities |
|
outputvalidation
Package outputvalidation provides a pure, self-contained validator that checks a tool's structured output against its declared JSON Schema (draft 2020-12).
|
Package outputvalidation provides a pure, self-contained validator that checks a tool's structured output against its declared JSON Schema (draft 2020-12). |
|
preflight
Package preflight is the shared eligibility evaluator behind the required-tools preflight (Spec 098): given a caller-supplied tool ID and a caller context, it answers `ready` or exactly one failure reason from a closed 15-code enum, by a fixed precedence chain.
|
Package preflight is the shared eligibility evaluator behind the required-tools preflight (Spec 098): given a caller-supplied tool ID and a caller context, it answers `ready` or exactly one failure reason from a closed 15-code enum, by a fixed precedence chain. |
|
profile
Package profile carries request-scoped in-proxy profile filtering (Spec 057).
|
Package profile carries request-scoped in-proxy profile filtering (Spec 057). |
|
qahooks
Package qahooks holds live-QA park points (Spec 116 PR3, quickstart L3).
|
Package qahooks holds live-QA park points (Spec 116 PR3, quickstart L3). |
|
qapilot
Package qapilot is the independent reference model for MCPProxy's quarantine and approval policy (the quarantine/approval testing pilot).
|
Package qapilot is the independent reference model for MCPProxy's quarantine and approval policy (the quarantine/approval testing pilot). |
|
redirectionguard
Package redirectionguard detects the Windows RedirectionGuard process mitigation on the current process (issue #1844).
|
Package redirectionguard detects the Windows RedirectionGuard process mitigation on the current process (issue #1844). |
|
registries
Catalog (Spec 109 FR-060-067, data-model §9): a source-agnostic, ranked view over every enabled registry ("catalog source"), fanned out in parallel and merged into one ordered list.
|
Catalog (Spec 109 FR-060-067, data-model §9): a source-agnostic, ranked view over every enabled registry ("catalog source"), fanned out in parallel and merged into one ordered list. |
|
sandbox
Package sandbox is a spike (MCP-3232) proving an *unprivileged*, non-Docker confinement primitive for stdio MCP servers on hosts where Docker is unavailable or broken — notably Ubuntu 24.04 with snap-installed Docker under AppArmor, where the deb's systemd hardening fights snap-confine (see internal repo issue #457 / cmd/mcpproxy/doctor_env_snapdocker.go).
|
Package sandbox is a spike (MCP-3232) proving an *unprivileged*, non-Docker confinement primitive for stdio MCP servers on hosts where Docker is unavailable or broken — notably Ubuntu 24.04 with snap-installed Docker under AppArmor, where the deb's systemd hardening fights snap-confine (see internal repo issue #457 / cmd/mcpproxy/doctor_env_snapdocker.go). |
|
secretlike
Package secretlike implements the one shared "does this field name look like a credential?" rule (Spec 109 research D13), used to default the Value/Secret toggle to Secret in Paste, Manual and Catalog-with-inputs surfaces (FR-065), and to compute CatalogResult.RequiredInputs[].secret_like when a registry omits or falsifies its own isSecret flag (FR-061).
|
Package secretlike implements the one shared "does this field name look like a credential?" rule (Spec 109 research D13), used to default the Value/Secret toggle to Secret in Paste, Manual and Catalog-with-inputs surfaces (FR-065), and to compute CatalogResult.RequiredInputs[].secret_like when a registry omits or falsifies its own isSecret flag (FR-061). |
|
security
Package security provides sensitive data detection for MCP tool calls.
|
Package security provides sensitive data detection for MCP tool calls. |
|
security/bundlesig
Package bundlesig implements the detached-signature sidecar format and the Ed25519 verification rules of Spec 101 (contracts/sidecar-format.md).
|
Package bundlesig implements the detached-signature sidecar format and the Ed25519 verification rules of Spec 101 (contracts/sidecar-format.md). |
|
security/detect
Package detect implements the deterministic, offline MCP tool-scanner v2 (Spec 076).
|
Package detect implements the deterministic, offline MCP tool-scanner v2 (Spec 076). |
|
security/patterns
Package patterns provides sensitive data detection patterns for various credential types.
|
Package patterns provides sensitive data detection patterns for various credential types. |
|
security/tpacorpus
Package tpacorpus builds the embedded TPA signature bundle from per-signature sources and enforces the corpus policy (spec 101 US2): provenance, licence allowlist, class vocabulary and the eval pair every gating signature owes.
|
Package tpacorpus builds the embedded TPA signature bundle from per-signature sources and enforces the corpus policy (spec 101 US2): provenance, licence allowlist, class vocabulary and the eval pair every gating signature owes. |
|
server
Spec 085 US3 — pre-dispatch argument validation (FR-013) and the self-healing invalid_params error renderer shared by Path A (pre-dispatch) and Path B (best-effort upstream classification).
|
Spec 085 US3 — pre-dispatch argument validation (FR-013) and the self-healing invalid_params error renderer shared by Path A (pre-dispatch) and Path B (best-effort upstream classification). |
|
shellwords
Package shellwords implements a small, dependency-free, quote-aware tokenizer for a single command line, shared by the Paste-source command detector (internal/configimport, FR-064) and the catalog install-command splitter (internal/registries, data-model §9 CatalogInstall).
|
Package shellwords implements a small, dependency-free, quote-aware tokenizer for a single command line, shared by the Paste-source command detector (internal/configimport, FR-064) and the catalog install-command splitter (internal/registries, data-model §9 CatalogInstall). |
|
shellwrap
Package shellwrap provides platform-level helpers for wrapping commands in the user's login shell and for resolving tool binaries (e.g.
|
Package shellwrap provides platform-level helpers for wrapping commands in the user's login shell and for resolving tool binaries (e.g. |
|
skills
Package skills holds the wire types and pure rules for skills served by an upstream MCP server through the io.modelcontextprotocol/skills extension.
|
Package skills holds the wire types and pure rules for skills served by an upstream MCP server through the io.modelcontextprotocol/skills extension. |
|
skills/index
Package index is a memory-only full-text index of skills (spec 125, D12).
|
Package index is a memory-only full-text index of skills (spec 125, D12). |
|
skills/skillstest
Package skillstest is a fake upstream MCP server that serves skills over raw JSON-RPC on HTTP.
|
Package skillstest is a fake upstream MCP server that serves skills over raw JSON-RPC on HTTP. |
|
storage/purgetest
Package purgetest seeds and inspects the Spec 116 removal purge set (data-model.md §PurgeSet) for tests.
|
Package purgetest seeds and inspects the Spec 116 removal purge set (data-model.md §PurgeSet) for tests. |
|
stringutil
Package stringutil provides common string utility functions.
|
Package stringutil provides common string utility functions. |
|
tokenseal
Package tokenseal seals and opens a byte slice as an "enc:v1" envelope (AES-256-GCM, random 96-bit nonce, HKDF-derived record key and key id) for values stored at rest, such as the upstream OAuth records in config.db.
|
Package tokenseal seals and opens a byte slice as an "enc:v1" envelope (AES-256-GCM, random 96-bit nonce, HKDF-derived record key and key id) for values stored at rest, such as the upstream OAuth records in config.db. |
|
toolannotations
Package toolannotations is the single source of truth for MCP tool-annotation filter semantics (Spec 035 F4, Spec 094 FR-004).
|
Package toolannotations is the single source of truth for MCP tool-annotation filter semantics (Spec 035 F4, Spec 094 FR-004). |
|
toolreview
Package toolreview holds the value types shared by the tool-review layers (storage, runtime and the security scanner) for Spec 117.
|
Package toolreview holds the value types shared by the tool-review layers (storage, runtime and the security scanner) for Spec 117. |
|
toolsig
Package toolsig compiles deterministic compact tool signatures (Spec 085, Compact Router) from a tool's JSON Schema (ToolMetadata.ParamsJSON) and its description.
|
Package toolsig compiles deterministic compact tool signatures (Spec 085, Compact Router) from a tool's JSON Schema (ToolMetadata.ParamsJSON) and its description. |
|
toonenc
Package toonenc implements the adaptive TOON encoder for tool-call result text blocks (spec 084).
|
Package toonenc implements the adaptive TOON encoder for tool-call result text blocks (spec 084). |
|
updatecheck
Package updatecheck provides centralized version checking against GitHub releases.
|
Package updatecheck provides centralized version checking against GitHub releases. |
|
upstream/callstats
Package callstats keeps a rolling, in-memory record of per-server tool-call outcomes so the health calculator can report a server whose calls mostly fail as degraded even though its connection looks fine (Spec 113-d).
|
Package callstats keeps a rolling, in-memory record of per-server tool-call outcomes so the health calculator can report a server whose calls mostly fail as degraded even though its connection looks fine (Spec 113-d). |
|
upstream/dialgate
Package dialgate is the per-instance retirement barrier of Spec 116 PR4 (#1564, FR-022..FR-026).
|
Package dialgate is the per-instance retirement barrier of Spec 116 PR4 (#1564, FR-022..FR-026). |
|
upstream/launcher
Package launcher manages locally-spawned upstream processes that expose their MCP endpoint over HTTP / SSE / streamable-HTTP transports.
|
Package launcher manages locally-spawned upstream processes that expose their MCP endpoint over HTTP / SSE / streamable-HTTP transports. |
|
upstream/limiter
Package limiter implements the bounded-concurrency admission control used by the upstream tool-call choke point (spec 093, GH #955).
|
Package limiter implements the bounded-concurrency admission control used by the upstream tool-call choke point (spec 093, GH #955). |
|
winjob
Package winjob provides Windows Job Object based process-tree cleanup.
|
Package winjob provides Windows Job Object based process-tree cleanup. |
|
scripts
|
|
|
gen-corpus-v2-dump
command
Command gen-corpus-v2-dump exports every indexed tool — with its FULL JSON input schema — from a mcpproxy Bleve index directory, as the raw material of the spec-083 schema-bearing frozen corpus (corpus_v2.tools.json).
|
Command gen-corpus-v2-dump exports every indexed tool — with its FULL JSON input schema — from a mcpproxy Bleve index directory, as the raw material of the spec-083 schema-bearing frozen corpus (corpus_v2.tools.json). |
|
specs
|
|
|
001-update-version-display/contracts
Package contracts defines types for the version/update feature.
|
Package contracts defines types for the version/update feature. |
|
test
|
|
|
launcher-server
command
Command launcher-server is a tiny HTTP MCP server used as the child process in the e2e test for spec 046 (local launcher for HTTP/SSE upstreams).
|
Command launcher-server is a tiny HTTP MCP server used as the child process in the e2e test for spec 046 (local launcher for HTTP/SSE upstreams). |
|
tests
|
|
|
oauthserver
Package oauthserver provides a reusable OAuth 2.1 test server for E2E testing.
|
Package oauthserver provides a reusable OAuth 2.1 test server for E2E testing. |
|
oauthserver/cmd/server
command
Standalone OAuth test server for browser-based testing (Playwright).
|
Standalone OAuth test server for browser-based testing (Playwright). |
|
tpa-attack-lab
command
Vector catalog for the TPA attack lab.
|
Vector catalog for the TPA attack lab. |
Click to show internal directories.
Click to hide internal directories.