🗺️ 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

Ctrl+Shift+P → CodeAtlas: Analyze Project

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

Pick your AI assistant and add the config:

🔵 VS Code (Copilot / GitHub Copilot Chat)

Open Settings (Ctrl+,) → search mcp → click Edit in settings.json, then add:

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

Or add via workspace .vscode/settings.json for per-project config.

🟢 Gemini

Add to .gemini/settings.json:

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

🟣 Claude Desktop

Add to claude_desktop_config.json:

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

⚫ Cursor

Add to .cursor/mcp.json:

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

🔴 Windsurf

Add to .windsurf/mcp.json:

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

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

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

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.

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.

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