# Devmap

> Devmap is an open-source MCP server for developer tools. Static-analysis map of your codebase, queried by agents for routes, flows and impact. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/itsflaid/devmap/tree/HEAD/packages/cli
- **MCP Registry name:** io.github.itsflaid/devmap
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add devmap -- npx -y @flaid/devmap
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "devmap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "devmap": {
      "command": "npx",
      "args": [
        "-y",
        "@flaid/devmap"
      ]
    }
  }
}
```

## Tools

- `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).

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/devmap
