Codeatlas
MCP server for CodeAtlas β exposes code analysis data to AI assistants via Model Context Protocol
Ask AI about Codeatlas
Powered by Claude Β· Grounded in docs
I know everything about Codeatlas. Ask me about installation, configuration, usage, or troubleshooting.
0/500
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_memoryafter 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.jsonunder~/.
π§βπ» 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.
