Codebase Context MCP

🚀 codebase-context-mcp

An MCP server for codebase indexing and search that is compatible with every platform, including ARM64 devices such as Raspberry Pi and Apple Silicon, where most alternatives fail.

🚀 Quick Start

This MCP server offers seamless codebase indexing and search capabilities across various platforms. For installation and usage details, refer to the following sections.

✨ Features

• Cross - platform Compatibility: Works on every platform, including ARM64 devices where many alternatives fail.
• WASM - based: Replaces native dependencies with WASM equivalents, ensuring npm install succeeds on any architecture.
• Drop - in Compatibility: Provides the same core tools via the standard MCP stdio transport.

📦 Installation

Claude Code (recommended)

claude mcp add codebase-context -s user -- npx codebase-context-mcp

Or from a local clone:

git clone https://github.com/Jhackman2019/codebase-context-mcp.git
cd codebase-context-mcp
npm install && npm run build
claude mcp add codebase-context -s user -- node /path/to/codebase-context-mcp/dist/index.js

MCP Settings (JSON)

{
  "mcpServers": {
    "codebase-context": {
      "command": "npx",
      "args": ["codebase-context-mcp"]
    }
  }
}

💻 Usage Examples

Tools

📚 Documentation

Supported Languages

TypeScript, TSX, JavaScript, Python, C#, VB.NET, XML, CSS, JSON

How It Works

• Parsing: web - tree - sitter (WASM) — same AST quality as native tree - sitter, runs on any architecture
• Search: BM25 text ranking (pure JS) + symbol name matching
• Storage: JSON file index at ~/.codebase-context-mcp/<project-hash>.json
• Transport: MCP stdio via @modelcontextprotocol/sdk
• Incremental: Files with unchanged content hash are skipped on re - index

Safety Limits

🔧 Technical Details

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. This approach ensures that npm install succeeds on the first try on any architecture, including ARM64 and x86_64, across macOS, Linux, and Windows.

📄 License

MIT