# devmap

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: itsflaid
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/itsflaid/devmap/tree/HEAD/packages/cli
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/devmap

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

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add devmap -- npx -y @flaid/devmap
```

### Codex

**Platform CLI**
```bash
codex mcp add cli -- npx -y @flaid/devmap
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "@flaid/devmap"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@flaid/devmap"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cli npx -y @flaid/devmap
```

## When to use it
- 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
- 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.ts` affect?
- Trace the main checkout flow.

## Similar
- [codesight-ai-context](https://affpapa.org/en/nevibecode/skills/codesight-ai-context.md) — skill · 559 installs
- [indexion-agent-orient](https://affpapa.org/en/nevibecode/skills/indexion-agent-orient.md) — skill · 4900 installs
- [BumpGuard](https://affpapa.org/en/nevibecode/mcp/bumpguard.md) — MCP server · ★ 5 repo stars
- [laravel-verification](https://affpapa.org/en/nevibecode/skills/laravel-verification.md) — skill · 6400 installs
- [wp-phpstan](https://affpapa.org/en/nevibecode/skills/wp-phpstan.md) — skill · 5300 installs
- [health-check](https://affpapa.org/en/nevibecode/skills/health-check.md) — skill · 4000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
