How do I install Codebase Context?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Codebase Context need an API key?

No required environment variable is listed on this record.

What transport does Codebase Context use?

Codebase Context runs locally over stdio.

When was Codebase Context last checked?

Last checked 2026-11-09. Codebase indexing and search via WASM tree-sitter. Works on ARM64 and x86_64.

Codebase Context MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.jhackman2019-codebase-context-mcp -- npx -y codebase-context-mcp@1.0.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.jhackman2019-codebase-context-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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

Supported Languages

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

Install

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"]
    }
  }
}

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

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)

Development

npm install
npm run build    # Build with tsup
npm run dev      # Watch mode
npm start        # Run the server

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Codebase Context?

Does Codebase Context need an API key?

What transport does Codebase Context use?

When was Codebase Context last checked?

Documentation

codebase-context-mcp

The Problem

The Solution

Tools

Supported Languages

Install

Claude Code (recommended)

MCP Settings (JSON)

How It Works

Safety Limits

Development

License