CodeAtlas MCP Server
Local-first MCP server for AI-powered codebase intelligence — AST analysis, dependency graphs, and semantic search. Your source code never leaves your machine.
🏗 Architecture
AI IDE → MCP stdio → Parser (AST) → Dependency Graph → Code Search
│
codeatlas-platform (HTTP) → Dreams + Genome| Layer | Components | |---|---| | Parser | TypeScript, Python, PHP AST analysis | | Graph | Dependency graph with chunked force layout | | Search | Semantic code search with regex safety | | Cloud | Optional: connect to codeatlas-platform for dreams/genome |
📊 Architecture Diagrams
| Diagram | File | |---|---| | MCP Server Flow | diagrams/mcp-server.mmd |
🔧 Quick Start
pnpm install
pnpm run build
# Local-only mode (no cloud):
node dist/index.js
# With cloud connection:
CODEATLAS_API_URL=http://localhost:8080 CODEATLAS_API_KEY=xxx node dist/index.js📡 MCP Tools (30)
| Category | Tools | |---|---| | Code Analysis | analyze_project, code_search, file_info | | AST | parse_file, find_symbol, get_dependencies | | Graphs | dependency_graph, call_graph | | Security | scan_vulnerabilities | | Cloud | save_dream_memory, query_dream_memories, sync_dreams | | Skills | search_skills, get_skill, install_skill |
🔗 Cloud Connection
Set CODEATLAS_API_URL and CODEATLAS_API_KEY to connect to a running codeatlas-platform instance for:
- Dream memory persistence
- Genome immune system
- Skills synchronization
