🗺️ CodeAtlas MCP Server

A standalone MCP server that exposes CodeAtlas analysis data to AI assistants — Gemini, Claude, Cursor, Windsurf, VS Code Copilot, and more.

⚡ Quick Start

1. Analyze your project

Install the CodeAtlas VS Code extension, then run:

Ctrl+Shift+P → CodeAtlas: Analyze Project

This generates .codeatlas/analysis.json in your project root.

2. Add MCP config

Pick your AI assistant and add the config:

{
  "mcp": {
    "servers": {
      "codeatlas": {
        "command": "npx",
        "args": ["-y", "@giauphan/codeatlas-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

That's it! Your AI assistant can now query your codebase structure, dependencies, and insights.

🛠️ Available Tools

| Tool | Description | |------|-------------| | list_projects | List all analyzed projects (auto-discovers ~/) | | get_project_structure | Get modules, classes, functions, variables | | get_dependencies | Get import / call / containment relationships | | get_insights | Get AI-generated code quality insights | | search_entities | Search functions, classes by name (fuzzy match) | | get_file_entities | Get all entities defined in a specific file |

📦 Alternative: Global Install

If you prefer installing globally instead of using npx:

npm install -g @giauphan/codeatlas-mcp

Then use "command": "codeatlas-mcp" (no args needed) in your MCP config.

🔧 Environment Variables

| Variable | Description | |----------|-------------| | CODEATLAS_PROJECT_DIR | Force a specific project directory |

By default, the server auto-discovers all projects with .codeatlas/analysis.json under your home directory.

🧑‍💻 Development

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm start

License

MIT