devmap — Claude Code MCP server: project map
The devmap MCP server for Claude Code answers questions about a project’s routes, features, files, and flows. It builds a code map for agents to query through tools.
MIT ★ 11 updated 2026-11-14
claude mcp add devmap -- npx -y @flaid/devmapWhat devmap does
devmap scans a project and creates a structured map of its routes, features, important files, and flows. An agent can request an overview, locate relevant code, inspect routes, or ask what an edit could affect. MCP tools return the results as structured data.
Run devmap analyze before adding the server with claude mcp add devmap -- npx -y @flaid/devmap mcp. By default, the MCP server reads the map without contacting an AI provider; AI-assisted explanations require --allow-ai. Node.js 22.12 or newer is required. Static analysis needs no API key, while AI interpretation requires a Groq, OpenRouter, or OpenAI-compatible provider key.
What it helps with
- locate routes and features in a project
- trace the files connected to a feature
- inspect the application’s main flows
- find which code a change may affect
Example prompts for the agent
- Show me the project’s route map and point out where its main features live.
- Which files relate to authentication, and what could changing
auth.tsaffect? - Trace the main checkout flow.
How to install devmap
Platform CLI
claude mcp add devmap -- npx -y @flaid/devmapPlatform CLI
codex mcp add cli -- npx -y @flaid/devmapConfig file
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Config file
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Platform CLI
gemini mcp add cli npx -y @flaid/devmapStep 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 devmap
How do I install devmap in Claude Code?
Run devmap analyze, then add the server with claude mcp add devmap -- npx -y @flaid/devmap. Node.js 22.12 or newer is required.
What does devmap do?
It builds a project map through static analysis and exposes it to an agent through MCP tools. The agent can query files, features, routes, and flows.
What does devmap need to run?
It requires Node.js 22.12 or newer. Static analysis works without an API key; AI interpretation needs a key for Groq, OpenRouter, or another OpenAI-compatible provider.