How do I use CodeAtlas MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CodeAtlas MCP Server show the module structure and dependencies for the current project" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🗺️ CodeAtlas MCP Server

npm version License TypeScript Node

A standalone MCP server that exposes CodeAtlas analysis data to AI assistants — Gemini, Claude, Cursor, Windsurf, 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

Copy the JSON block below into one of these files depending on your AI assistant:

AI Assistant	Config file
Gemini	`.gemini/settings.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	`.cursor/mcp.json`
Windsurf	`.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.

🛠️ 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 update your MCP config to:

{
  "mcpServers": {
    "codeatlas": {
      "command": "codeatlas-mcp"
    }
  }
}

🔧 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

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

CodeAtlas MCP Server