Code Atlas MCP server
io.github.lusiem/code-atlas·v0.5.0Code intelligence MCP: symbols, call graphs, change impact + affected tests, routes, search.
0 stars30 downloads/wk
Reviews
Write oneNobody has reviewed Code Atlas yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Code Atlas tools (31, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
ast_querywrite actionRun a raw tree-sitter S-expression query over indexed files of one language and return every capture
batch_symbolsCompact one-line info for up to 50 symbol ids in a single call — resolve the #ids from
call_hierarchyWho calls this symbol (direction=in) or what it calls (direction=out), as a tree up to `depth` levels.
change_couplingWhich files historically change together with this one? Directional: "when I touch A, B changes
change_impactBlast radius of a change: transitive callers/subtypes of the target plus files reachable
context_packOne-call, token-budgeted briefing on a symbol: definition source, surrounding file outline,
find_asset_referencesReverse lookup across engine assets: which scenes/prefabs/Blueprints reference this script,
find_dead_codeSymbols nothing references: no resolved occurrence and no graph edge points at them, after
find_referencesUsages of a symbol. Uses the exact language server when one is available (provenance lsp),
find_routeWhich code serves this URL? Matches a concrete request path (e.g. "/api/users/7") against
find_similar_codeDoes a helper for this already exist? Near-duplicate search over the indexed code: target an
generate_diagramRender index data as a Mermaid diagram (returned in a ```mermaid fence — paste into GitHub
get_dependenciesWhat a file imports (direction=out) or which files import it (direction=in).
get_file_outlineHierarchical outline of every definition in a file, with signatures — read the structure of a file
get_scene_structureNode tree of a game-engine scene file with attached scripts, instanced sub-scenes, and
get_symbol_infoFull detail for one symbol: signature, doc comment, location, container — and optionally its source.
go_to_definitionDefinition site of the identifier at a file position. Uses the exact language server when
hotspotsRisk-ranked files: git commit churn over a window multiplied by current size
index_statusIndexing progress, per-file errors, and freshness of the code index.
list_routesWeb-framework routes indexed across the workspace (Express, Fastify, NestJS, FastAPI, Flask,
project_overviewCheap orientation router: languages, file/symbol counts, index freshness, top-level layout,
reindexForce an incremental re-scan of the workspace (hash-checks every file, reindexes changed ones).
repo_mapAnnotated architecture map of the workspace — the first call to make in an unfamiliar repo.
search_reflectionFind engine-reflected declarations: Unreal UCLASS/UPROPERTY/UFUNCTION specifiers
search_symbolsSearch definitions (functions, classes, methods, …) by name across the whole workspace.
semantic_searchNatural-language search over the code: describe behavior ("where is retry backoff implemented",
symbol_historyHow did this symbol get this way? Line-range git history (git log -L) for the symbol's span:
tests_for_symbolWhich tests exercise this symbol? Walks the call/type graph backwards from the target to
trace_pathShortest call chain from one symbol to another over the indexed call graph —
type_hierarchySupertypes (direction=super: what this type extends/implements) or subtypes
verify_changeswrite actionPost-edit structural check of the uncommitted working tree (or explicit files) against git HEAD:
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan185 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 52 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Code Atlas compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 80% of 3,470 Web search servers
- Tools
- 31
- the typical Web search server has 5
- Tools that change things
- 6%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 30
- more than 16% of 827 Web search servers with a package
What its tools let an agent do: 28 read · 1 create · 2 change
Install Code Atlas in Claude Code, Cursor or VS Code
Runs npx -y @lusiem/code-atlas on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add code-atlas -- npx -y @lusiem/code-atlas
What the publisher says
From the Code Atlas repository's README, as published. We do not edit it. Read it on GitHub
code-atlas
Multi-language code intelligence MCP server — gives Claude Code (and any MCP client) a structured view of your codebase instead of raw text: symbol search, file outlines, AST pattern queries, cross-file references, call/type hierarchies, import graphs, change-impact analysis with affected-test detection, web-framework route maps (Express/NestJS/Fastify/FastAPI/Flask/Django), Mermaid diagrams, precise LSP-backed answers, local-embedding semantic search, and game-engine asset understanding (Godot, Unity, Unreal). 25 languages indexed.
Instead of grepping and reading whole files, the model asks questions like "map this repo", "outline this file", "who calls parseConfig?", "how does the request handler reach the DB layer?", "what changes whenever this file changes?" — and gets compact, token-efficient answers backed by a persistent tree-sitter index.
Every answer is budgeted: tools take a max_tokens cap, and a clamped response returns a cursor you can pass back to continue rather than re-asking with a bigger budget.
Status: released (npm @lusiem/code-atlas, MCP registry io.github.lusiem/code-atlas). 25 languages, 32 tools, LSP-exact answers with a structural floor, engine adapters, and an agent-workflow layer (repomap, contextpack, verify_changes) built for token economy. Validated at 19k files / 6.3M LOC.
How it works
your repo ──scan (gitignore-aware)──> tree-sitter parse ──> SQLite index (symbols, imports,
occurrences, call/type edges, FTS5)
│
Claude Code ◄──────────── MCP tools over stdio ────────────────────┘- Persistent index at /.code-atlas/index.db (self-gitignored), incrementally refreshed by content hash.
- Live — a gitignore-aware file watcher reindexes saves within a debounce beat and re-resolves only the affected files (--no-watch or "watch": false to disable).
- Zero config — point it at a repo root and it works. Optional code-atlas.json for include/exclude tweaks.
- Everything local — your code never leaves your machine.
Install & use with Claude Code
claude mcp add code-atlas -- npx -y @lusiem/code-atlas serveOr from a clone:
git clone https://github.com/lusiem/code-atlas && cd code-atlas
npm install && npm run build
claude mcp add code-atlas -- node /path/to/code-atlas/dist/index.js serveThe server indexes the current working directory; pass --root to override.
CLI
node dist/index.js index [--root <path>] # one-shot index build (debugging / warm-up)
node dist/index.js serve [--root <path>] [--no-watch] [--no-lsp] [--no-embeddings] [--no-download]
# MCP server on stdioTools
Full reference with example outputs: docs/tools.md.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Code Atlas: common questions
- Is Code Atlas MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Code Atlas safety report
- How do I install Code Atlas?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Code Atlas need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Code Atlas maintained?
- The last commit was 92 days ago (2026-08-04). The latest release is v0.5.0.
- What can I use instead of Code Atlas?
- Servers from other publishers that do the same job: Crg MCP server, Codeseeker MCP server and The Company Atlas MCP server.
- How does Code Atlas compare with other Web search MCP servers?
- safety score 88/100 (higher than 80% of 3,470 Web search servers); tools 31 (the typical Web search server has 5); tools that change things 6% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Code Atlas
Same job from other publishers: the closest match first, then the best rated.
- CrgToken-efficient code review knowledge graph: semantic search and call-graph resolution.not reviewedEstablishedB
- CodeseekerGraph-powered code intelligence with semantic search and knowledge graph for AI assistantsnot reviewedGrowingC
- The Company AtlasGlobal customs trade data and company registry. Search shipments, and look up legal entities.5.0(1)NewB
- ArxivSearch arXiv papers, download full text, semantic search, citation graphs, and alerts via MCP.not reviewedWidely usedA
- SocraticodeMCP server for enterprise local codebase indexing, semantic search, and code dependency graphs.not reviewedEstablishedB