About Codeatlas
Codeatlas is an MCP server in the Commerce category: 🗺️ AI-powered code analysis for VS Code, Cursor & Windsurf — MCP server with 10 tools + persistent AI memory across conversations. TypeScript, JavaScript, Python, PHP.
The repository has 2 stars and 0 forks.
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.
Tools (6)
get_dependenciesImport/call/containment relationships
Parameters not published.
get_file_entitiesAll entities in a specific file
Parameters not published.
get_insightsCode quality & security analysis
Parameters not published.
get_project_structureGet modules, classes, functions
Parameters not published.
list_projectsList all analyzed projects
Parameters not published.
search_entitiesFuzzy search entities by name
Parameters not published.
Ask AI
Ask AI about Codeatlas
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run 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 copy captured when this server was indexed; it may lag the repository. The original is authoritative.