Skip to content
MCP server

Devmap

Static-analysis map of your codebase, queried by agents for routes, flows and impact

Runs locallyStatus and history
Install
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/devmap

Add to claude_desktop_config.json

{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers