calm-mcp — Claude Code MCP server: setup
calm-mcp gives coding agents a live call graph, dependency context, and checked writes. It fits refactoring tasks where missed callers are risky.
claude mcp add calm-mcp -- npx -y @eilodon/calm-mcpWhat calm-mcp does
calm-mcp exposes a codebase map through MCP instead of treating text search as the whole picture. Agents can inspect callers, callees, imports, edit context, and highly connected symbols. The index follows file changes and reports its current stage. It parses 24 languages, with call graphs available by default for 13 of them.
Before a write reaches disk, the server checks the target range against its hash and runs a syntax check. Changes to high fan-in symbols are refused until the agent reviews their callers and confirms the edit. fitness_report makes code structure and architecture checks queryable, while remember and recall carry decisions between sessions. Indexing, search, and editing stay on the local machine. Compiler-backed upgrades depend on an available provider or toolchain; when one is absent, the base behavior remains unchanged.
What it helps with
- trace every caller before changing a function
- inspect the impact of a cross-module edit
- block an unconfirmed change to a hub symbol
- surface dead code and boundary violations
- carry decisions across agent sessions
Example prompts for the agent
- Use
callersto list every call site before changing this function’s signature. - Run
edit_contextfor the planned file change and verify the write safeguards. - Generate a
fitness_reportcovering dead code and architecture-boundary violations.
How to install calm-mcp
Platform CLI
claude mcp add calm-mcp -- npx -y @eilodon/calm-mcpPlatform CLI
codex mcp add calm-mcp -- npx -y @eilodon/calm-mcpConfig file
{
"mcpServers": {
"calm-mcp": {
"command": "npx",
"args": [
"-y",
"@eilodon/calm-mcp"
]
}
}
}Config file
{
"servers": {
"calm-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@eilodon/calm-mcp"
]
}
}
}Platform CLI
gemini mcp add calm-mcp npx -y @eilodon/calm-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about calm-mcp
How do I install calm-mcp in Claude Code?
Run claude mcp add calm-mcp -- npx -y @eilodon/calm-mcp.
What does calm-mcp do?
It gives a coding agent a live graph of calls and imports, then checks risky edits against the current file content and syntax.
What happens when a compiler provider is unavailable?
The formal edge upgrade is skipped. Base indexing and the server’s other behavior continue to work.
