fixmap — Claude Code MCP server: what it does, how to install
Builds deterministic impact and context maps from issues or diffs. Guides coding assistants to the right files without third-party model queries.
claude mcp add fixmap -- npx -y @aryam/fixmapWhat fixmap does
The server inspects repositories against an issue description, commit range, or working tree state. It highlights primary files, downstream dependents, and related tests before changes begin. Every suggested path includes rationale and marks uncertain areas directly in the output.
It traces imports, workspace packages across npm, pnpm, Yarn, or Bun, and recurring co-change patterns from Git logs. Agents can receive raw file targets or targeted source slices constrained by a token budget. Cached repository data expires after seven days.
Node.js 20.11 or newer is required. Everything computes on your machine without third-party token balances or account logins.
What it helps with
- identify key source files to fix an incoming bug report
- map relevant test files affected by local modifications
- verify a staged diff against the saved task plan
- generate Mermaid graphs showing component relationships for pull requests
Example prompts for the agent
- Run fixmap to find candidate files for GitHub issue https://github.com/chalk/chalk/issues/624
- Prepare targeted context for the password reset error within a 10000 token limit
- Verify our current branch diff against plan.json
How to install fixmap
Platform CLI
claude mcp add fixmap -- npx -y @aryam/fixmapPlatform CLI
codex mcp add fixmap -- npx -y @aryam/fixmapConfig file
{
"mcpServers": {
"fixmap": {
"command": "npx",
"args": [
"-y",
"@aryam/fixmap"
]
}
}
}Config file
{
"servers": {
"fixmap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aryam/fixmap"
]
}
}
}Platform CLI
gemini mcp add fixmap npx -y @aryam/fixmapStep 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 fixmap
How do I install fixmap in Claude Code?
Run claude mcp add fixmap -- npx -y @aryam/fixmap in your terminal. You must have Node.js 20.11 or later installed.
What does fixmap do?
It determines which source files, tests, and dependencies matter for a given bug or task. The resulting ranking helps AI agents focus on critical code without reading the entire repository.
Does fixmap require an LLM API key?
No external model accounts or API keys are required. The tool runs locally and maps your project through deterministic graph analysis and Git history.
