Client configuration and agent workflows
Clients start the same installed command with an absolute root:
{ "command": "complexity-mcp", "args": ["--root", "/absolute/path/to/project"]}VS Code and GitHub Copilot
Section titled “VS Code and GitHub Copilot”Create .vscode/mcp.json with a named stdio server and ${workspaceFolder} as the root. Use MCP: List Servers to start or inspect it.
codex mcp add complexity-analysis -- complexity-mcp --root /absolute/path/to/projectcodex mcp listClaude Desktop
Section titled “Claude Desktop”Add the command under mcpServers in claude_desktop_config.json, then fully restart Claude Desktop. GUI applications may inherit a different PATH than an interactive shell.
Efficient investigation
Section titled “Efficient investigation”For a large project:
- call
analyze_projectwithresponseMode: "summary"; - inspect
isTruncated,totalMemberCount, and the stable member identities; - call
query_member_evidencewith the returnedanalysisIdand selectedStableId; - ask the agent to distinguish proven estimates, assumptions, and
Unknownreasons.
The cache is bounded and exact. If an analysis was not retained or was evicted, the server fails explicitly rather than substituting potentially stale data.