print-mcp-diff-configs

Overview ¶

Command print-mcp-diff-configs emits the configuration matrix consumed by the mcp-server-diff GitHub Action. The matrix is composed of three parts:

1. Hand-curated baseline configs (default, read-only, common toolset combos)
2. Insiders configs (--insiders, --insiders --read-only) — meta flag that expands to the curated insiders feature set
3. One config per entry in github.AllowedFeatureFlags — automatically kept in sync with the Go source so any new user-controllable feature flag gets diffed without touching the workflow

The same logical matrix is rendered for two transports, selected by -transport:

stdio Default. Args are appended to the action's top-level

start_command (one stdio process per config).

http-headers streamable-http transport against a shared HTTP server. The

server is started once with no extra flags and every config
provides its settings via X-MCP-* request headers, mirroring
how the remote server is invoked in production (server-side
defaults + per-user header overrides).

Usage:

go run ./script/print-mcp-diff-configs go run ./script/print-mcp-diff-configs -transport http-headers