📦

Codeatlas

MCP server for CodeAtlas — exposes code analysis data to AI assistants via Model Context Protocol

0 installs

Trust: 37 — Low

Commerce

Ask AI about Codeatlas

I know everything about Codeatlas. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

🗺️ CodeAtlas MCP Server

Give your AI assistant deep understanding of any codebase

A standalone MCP server that exposes code analysis data to Gemini, Claude, Cursor, Windsurf, VS Code Copilot — with persistent AI memory between conversations.

✨ What Does It Do?

Your Code → CodeAtlas Analyze → MCP Server → AI Understands Everything
                                     │
                              10 powerful tools:
                              • Search functions & classes
                              • Trace feature flows
                              • Generate architecture diagrams
                              • Persistent memory across conversations

Before CodeAtlas: AI greps blindly, forgets your project every conversation. After CodeAtlas: AI instantly knows your architecture, dependencies, and remembers context.

🚀 Setup (1 minute)

1. Analyze your project

Install the CodeAtlas extension, then:

Ctrl+Shift+P → CodeAtlas: Analyze Project

2. Add MCP config to your AI

🟢 Gemini / Antigravity — .gemini/settings.json

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

⚫ Cursor — .cursor/mcp.json

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

🔵 VS Code Copilot — .vscode/settings.json

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

🟣 Claude Desktop — claude_desktop_config.json

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

🟣 Claude Code CLI

claude mcp add codeatlas -- npx -y @giauphan/codeatlas-mcp

🔴 Windsurf — .windsurf/mcp.json

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

Done! Your AI can now use all 10 CodeAtlas tools.

🛠️ 10 MCP Tools

Code Analysis (6 tools)

Tool	Description	Example Use
`list_projects`	List all analyzed projects	"What projects do I have?"
`get_project_structure`	Get modules, classes, functions	"Show me all classes"
`get_dependencies`	Import/call/containment relationships	"What does UserService depend on?"
`get_insights`	Code quality & security analysis	"Any security issues?"
`search_entities`	Fuzzy search entities by name	"Find the login function"
`get_file_entities`	All entities in a specific file	"What's in auth.ts?"

Architecture Visualization (2 tools)

Tool	Description	Example Use
`generate_system_flow`	Mermaid architecture diagram (module imports)	"Show me the system architecture"
`generate_feature_flow_diagram` ⭐	Mermaid execution flow diagram (call chains)	"How does the payment feature work?"

AI Memory (2 tools)

Tool	Description	Example Use
`sync_system_memory`	Save context to `.agents/memory/`	"Remember what we changed"
`trace_feature_flow`	Trace feature through codebase	"What files are involved in auth?"

🧠 AI Memory — Persistent Context

AI assistants forget everything between conversations. CodeAtlas fixes this:

Conversation 1 → AI analyzes code → sync_system_memory
                                          │
                                   .agents/memory/
                                   ├── system-map.md       ← Architecture diagram
                                   ├── modules.json        ← All entities
                                   ├── conventions.md      ← Code patterns
                                   ├── business-rules.json ← Domain logic
                                   ├── feature-flows.json  ← Feature traces
                                   └── change-log.json     ← Change history
                                          │
Conversation 2 → AI reads memory → full context restored instantly ✨

Auto-Generated IDE Rules

When you run Analyze Project, CodeAtlas auto-creates rule files for your AI IDE:

Generated File	For
`.agents/rules/codeatlas-mcp.md`	All AI assistants
`.cursor/rules/codeatlas.mdc`	Cursor
`CLAUDE.md`	Claude Code
`.windsurfrules`	Windsurf

These tell your AI to:

Read .agents/memory/ at the start of every conversation
Use MCP tools before making changes
Call sync_system_memory after completing changes

🌍 Supported Languages

Language	Features
TypeScript / JavaScript	Full AST: imports, classes, functions, variables, calls, implements
Python	Classes, functions, variables, imports, calls
PHP	Classes, interfaces, traits, enums, functions, properties
Blade Templates	`@extends`, `@include`, `@component`, `<x-component>`

📦 Alternative: Global Install

npm install -g @giauphan/codeatlas-mcp

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

🔧 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 ~/.

🧑‍💻 Development

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm test    # 6 tests
npm start   # Start MCP server

🔗 Related

CodeAtlas Extension — VS Code extension with interactive code graph
MCP Protocol — Model Context Protocol standard

License

MIT — Free for personal and commercial use.