@ashwindojo/codeatlas-mcp

Let Claude Desktop and Cursor understand your frontend codebase — without a running dev server.

Point this standalone MCP server at any React, Vue, or Svelte project and AI tools instantly gain structured knowledge of your business flows, state management, API layers, team ownership, and critical paths. Powered by the Model Context Protocol with optional semantic search via LangChain + OpenAI.

Install

npm install -D @ashwindojo/codeatlas-mcp

Setup — 2 steps

Step 1 — Index your project

npx @ashwindojo/codeatlas-core index ./my-app
# Creates .codeatlas/index.json

Step 2 — Point Claude Desktop at the server

In ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "codeatlas": {
      "command": "node",
      "args": ["/absolute/path/to/my-app/node_modules/@ashwindojo/codeatlas-mcp/dist/server.js"],
      "env": {
        "CODEATLAS_ROOT": "/absolute/path/to/my-app"
      }
    }
  }
}

Restart Claude Desktop. Done.

Connect to Cursor

In Cursor → Settings → MCP:

{
  "mcpServers": {
    "codeatlas": {
      "command": "node",
      "args": ["/absolute/path/to/my-app/node_modules/@ashwindojo/codeatlas-mcp/dist/server.js"],
      "env": {
        "CODEATLAS_ROOT": "/absolute/path/to/my-app"
      }
    }
  }
}

What you can ask Claude

Once connected, ask anything about your codebase:

"Index my project at /workspace/my-app, then list all business flows" "What Redux state does the payments flow use?" "Which team owns the auth feature?" "Show me all business-critical code paths" "What third-party integrations does the checkout flow have?"

Available MCP tools

| Tool | Description | |---|---| | index_repo | Scan and index a project (run this first) | | get_repo_context | Full overview: flows, states, APIs, owners, critical paths | | get_flow_context | Deep dive into one business flow | | get_component_context | Context for one annotated component | | list_flows | All flows with component/state/API counts | | search_flows | Search across names, files, and annotations | | ask_codebase | Natural language Q&A — requires OPENAI_API_KEY |

Enable semantic search (optional)

Add your OpenAI key to unlock vector search and natural-language Q&A:

"env": {
  "CODEATLAS_ROOT": "/absolute/path/to/my-app",
  "OPENAI_API_KEY": "sk-..."
}

| Feature | Without key | With key | |---|---|---| | All query tools | ✅ Full text search | ✅ Vector similarity search | | ask_codebase | ❌ | ✅ GPT-powered Q&A |

When to use this vs the Vite plugin

| Scenario | Use | |---|---| | Active vite dev session | @ashwindojo/codeatlas-vite-plugin — live, updates on save | | Claude Desktop, CI, non-Vite projects | This package — reads from .codeatlas/index.json |

Keep the index fresh in CI

# .github/workflows/codeatlas.yml
- name: Update CodeAtlas index
  run: npx @ashwindojo/codeatlas-core index .
- uses: actions/upload-artifact@v4
  with:
    name: codeatlas-index
    path: .codeatlas/index.json

Part of the CodeAtlas ecosystem

| Package | What it does | |---|---| | @ashwindojo/codeatlas-core | Parser, indexer, CLI | | @ashwindojo/codeatlas-vite-plugin | Live MCP server inside vite dev | | @ashwindojo/codeatlas-mcp | Standalone MCP server for Claude Desktop & Cursor ← you are here |

MIT © 2026