jhackman2019 avatar

Codebase Context Mcp

jhackman2019/codebase-context-mcp

Gives Claude indexing and search across your codebase without requiring native binaries. Ships with WASM tree-sitter so it installs cleanly on ARM64 (Raspberry Pi, Apple Silicon, Graviton) and x86_64 alike. Exposes five tools: index_codebase to parse a directory into symbols and chunks stored as JSON, search_symbols for finding functions and classes by name, search_code for BM25 full-text search, get_file_outline for file structure with line numbers, and get_project_summary for tech stack overview. Supports TypeScript, JavaScript, Python, C#, and a handful of other languages. Respects gitignore and caps files at 512KB. Useful when you want symbol navigation and code search without fighting npm install failures on non-x86 platforms.

tools
5
transport
STDIO
last updated
Feb 13, 2026

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

index_codebaseParse a directory into symbols/chunks, cache as JSON

Parse a directory into symbols/chunks, cache as JSON

No parameter schema in public metadata yet.

search_symbolsFind functions, classes, types by name or pattern

Find functions, classes, types by name or pattern

No parameter schema in public metadata yet.

search_codeBM25 full-text search across indexed files

BM25 full-text search across indexed files

No parameter schema in public metadata yet.

get_file_outlineFile structure: functions, classes, imports, exports with line numbers

File structure: functions, classes, imports, exports with line numbers

No parameter schema in public metadata yet.

get_project_summaryTech stack, file counts by language, directory structure

Tech stack, file counts by language, directory structure

No parameter schema in public metadata yet.

Sponsors

Readme

codebase-context-mcp

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.

The Problem

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.

The Solution

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.

Tools


View the full README on GitHub

Details

Repository
github.com/jhackman2019/codebase-context-mcp
Category
Search & Web Crawling
Package
codebase-context-mcp
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1jnilrac avatarSecant Agent Research Packjnilrac/secant-agent-research-mcpPaid MCP web research for agents: search, extraction, citations, and x402 payment discovery.0stars
2kapoost avatarhumanMCP Marketplace — federated listings across personal MCP serverskapoost/humanmcp-marketplaceFederated listings from personal humanMCP servers. Search offers, trades by humans.0stars
3city24 avatarCity24.lv - Real Estate marketplacelv.city24/real-estateLive Latvia real estate listings with search, geo filters, and property metadata.0stars
4mshegolev avatarJaeger Mcpmshegolev/jaeger-mcpJaeger MCP — search traces, inspect spans, map service dependencies (read-only).0stars
5mshegolev avatarPrometheus Mcpmshegolev/prometheus-mcpPrometheus MCP — query metrics, inspect alerts, and explore scrape targets (read-only).0stars
6periodix avatarPeriodix Actionsnet.periodix/actionsSearch LinkedIn & Sales Navigator. Get structured people, companies, posts, jobs data. 4.9/5 on G2.0stars