loading…
Search for a command to run...
loading…
Exposes codebase analysis data, including module structures, dependencies, and AI-generated insights, to AI assistants via the Model Context Protocol. It enable
Exposes codebase analysis data, including module structures, dependencies, and AI-generated insights, to AI assistants via the Model Context Protocol. It enables users to query project architecture and search for specific code entities across analyzed projects.
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.
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.
Install the CodeAtlas extension, then:
Ctrl+Shift+P → CodeAtlas: Analyze Project
.gemini/settings.json{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
.cursor/mcp.json{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
.vscode/settings.json{
"mcp": {
"servers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
}
claude_desktop_config.json{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
claude mcp add codeatlas -- npx -y @giauphan/codeatlas-mcp
.windsurf/mcp.json{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
Done! Your AI can now use all 10 CodeAtlas 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?" |
| 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?" |
| 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 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 ✨
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:
.agents/memory/ at the start of every conversationsync_system_memory after completing changes| 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> |
npm install -g @giauphan/codeatlas-mcp
Then use "command": "codeatlas-mcp" in your MCP config (no args needed).
| Variable | Description |
|---|---|
CODEATLAS_PROJECT_DIR |
Force a specific project directory |
By default, the server auto-discovers all projects with
.codeatlas/analysis.jsonunder~/.
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
MIT — Free for personal and commercial use.
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"codeatlas-mcp-server": {
"command": "npx",
"args": []
}
}
}