The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Codebase Context MCP listing page.
MCP server for codebase indexing and search that works on every platform — including ARM64 devices like Raspberry Pi and Apple Silicon where most alternatives fail.
Popular codebase-indexing MCP servers like @zilliz/claude-context-mcp depend on native C++ bindings (tree-sitter, faiss-node) that ship pre-built binaries only for x86_64. If you're on ARM64 — a Raspberry Pi, Apple Silicon Mac, AWS Graviton, or any other arm64 host — npm install fails with missing prebuilts and no fallback. There's no workaround short of cross-compiling the native modules yourself.
This package replaces every native dependency with a WASM equivalent. The tree-sitter parser runs as WebAssembly, search uses a pure-JS BM25 implementation, and the index is stored as plain JSON. Zero native bindings means npm install succeeds on the first try on any architecture: ARM64, x86_64, macOS, Linux, Windows.
Drop-in compatible — provides the same core tools (index, search, outline, summary) via the standard MCP stdio transport.
| Tool | Description |
|---|---|
index_codebase | Parse a directory into symbols/chunks, cache as JSON |
search_symbols | Find functions, classes, types by name or pattern |
search_code | BM25 full-text search across indexed files |
get_file_outline | File structure: functions, classes, imports, exports with line numbers |
get_project_summary | Tech stack, file counts by language, directory structure |
TypeScript, TSX, JavaScript, Python, C#, VB.NET, XML, CSS, JSON
Or from a local clone:
web-tree-sitter (WASM) — same AST quality as native tree-sitter, runs on any architecture~/.codebase-context-mcp/<project-hash>.json@modelcontextprotocol/sdk| Limit | Value |
|---|---|
| Max files | 20,000 |
| Max file size | 512KB |
| Default ignores | node_modules, .git, dist, build, .venv, binaries, lock files |
| .gitignore | Respected (root level) |
MIT