Devmap
Static-analysis map of your codebase, queried by agents for routes, flows and impact
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.9.0
- Listing updated
- today
Similar MCP servers
About Devmap
Devmap is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Instead of re-explaining a project to every new chat, devmap analyses it once and lets an agent query the result. The CLI builds a map in a .devmap folder (an index, per-feature maps and a full snapshot) plus a DEVMAP.md guide, and the MCP server answers tool calls with structured JSON rather than a giant context file.
It exposes devmap_overview, devmap_map, devmap_flow, devmap_routes, devmap_impact, devmap_find and devmap_analyze, with devmap_explain only when started with --allow-ai. By default it is read-only and static: no AI provider is contacted, it writes only inside .devmap when devmap_analyze is called or --auto-refresh is set, and each answer says whether the snapshot is stale.
Analysis recognises frontends such as Next.js, Astro, SvelteKit, Nuxt and Angular and backends such as Express, NestJS, Fastify and Hono, with Next.js and Express going deepest. The CLI needs Node.js 22.12 or newer; optional AI interpretation uses Groq, OpenRouter or any OpenAI-compatible endpoint, and repository source is not sent wholesale to the model.
Install
Run in a terminal
claude mcp add devmap -- npx -y @flaid/devmapAdd to claude_desktop_config.json
{
"mcpServers": {
"devmap": {
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"devmap": {
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"devmap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"devmap": {
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"devmap": {
"command": "npx",
"args": [
"-y",
"@flaid/devmap"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- devmap_overview
- Overview of the project map.
- devmap_map
- Project map, optionally scoped to a feature or file.
- devmap_flow
- Curated top flows.
- devmap_routes
- List routes.
- devmap_impact
- Impact of a change.
- devmap_find
- Find code in the map.
- devmap_analyze
- Re-run the analysis and refresh the snapshot.
- devmap_explain
- Explain a file, feature or function (only with --allow-ai).
What it does
- Analyse once, reuse
- A persistent map replaces re-scanning the repo each session.
- Impact queries
- devmap_impact shows what a change may affect.
- Route and flow listing
- Pull routes and curated top flows for a project.
- Static by default
- No AI provider is contacted unless --allow-ai is set.
- Staleness reporting
- Every answer states whether the snapshot is out of date.
- Broad stack detection
- Covers many frontend and backend frameworks.
Good for
- Onboard an agent to an unfamiliar codebase
- List all routes in a Next.js or Express app
- Check the impact of editing a file
- Find which feature owns a piece of code
- Keep AGENTS.md and a project guide up to date
Pricing
Open source
MIT licence
Devmap FAQ
Does it need an AI key?
Not for static analysis; Groq, OpenRouter or a compatible key is only for optional AI interpretation.
Does it send my code to a model?
The README says full repository source is not sent to the provider, and .env files are ignored.
What does it need to run?
Node.js 22.12 or newer.
Does it modify my project?
It writes inside .devmap, and never overwrites existing AGENTS.md or DEVMAP.md files.
Is Devmap free?
Yes. Devmap is open source, so you can use and self-host it for free.
How do I add Devmap to Claude Code?
Run this command in your terminal: claude mcp add devmap -- npx -y @flaid/devmap
What are the best alternatives to Devmap?
The closest alternatives to Devmap are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


