About Codeatlas
Codeatlas is an MCP server in the Commerce category: mCP server for CodeAtlas — exposes code analysis data to AI assistants via Model Context Protocol. It has been installed 0 times through Conduid.
Install
claude mcp add codeatlas -- npx -y @giauphan/codeatlas-mcpnpx -y @giauphan/codeatlas-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Codeatlas
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
🗺️ 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
{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
{
"mcp": {
"servers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
}
{
"mcpServers": {
"codeatlas": {
"command": "npx",
"args": ["-y", "@giauphan/codeatlas-mcp"]
}
}
}
claude mcp add codeatlas -- npx -y @giauphan/codeatlas-mcp
{
"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.
README mirrored from the source repository 5 months ago. The original is authoritative.