Codebase Context Mcp

io.github.Jhackman2019Published by GitHub account Jhackman2019v1.0.1Updated Oct 24, 2026

Codebase indexing and search via WASM tree-sitter. Works on ARM64 and x86_64.

The publisher's own server: Codebase

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

A local MCP server that indexes a codebase with WASM tree-sitter and lets an assistant search symbols, run full-text code search, and outline files.

What you can do
Index a directory into symbols and chunks, cached as JSON and updated incrementally by content hash, with default ignores and file limits applied. Find functions, classes and types by name or pattern. Run BM25 full-text search across indexed files. Show a file outline of functions, classes, imports and exports with line numbers. Summarize the project's tech stack, file counts by language and directory structure.
When to use it
Useful when an assistant needs to navigate and search a local codebase, especially on ARM64 hosts such as Raspberry Pi, Apple Silicon or Graviton where native-binding indexers fail to install. Suited to projects in TypeScript, TSX, JavaScript, Python, C#, VB.NET, XML, CSS or JSON.
Requirements
Runs as a local stdio process, typically launched with npx from the npm package codebase-context-mcp, so Node.js and npm are needed. No authentication, environment variables or headers are declared. The index is written to a JSON file under the user's home directory.
Before you install
Indexing reads source files from the chosen directory and stores parsed content in a JSON index under the home directory, so sensitive code may be persisted there. Default ignores cover node_modules, .git, dist, build, .venv, binaries and lock files, and root-level .gitignore is respected, but other secrets in the tree are not filtered. Limits are 20,000 files and 512KB per file.

Installation

In SourceWeft

  1. Open Codebase Context Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

ToolDescription
index_codebaseParse a directory into symbols/chunks, cache as JSON
search_symbolsFind functions, classes, types by name or pattern
search_codeBM25 full-text search across indexed files
get_file_outlineFile structure: functions, classes, imports, exports with line numbers
get_project_summaryTech stack, file counts by language, directory structure

Supported Languages

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

Install

Claude Code (recommended)

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

Or from a local clone:

bash
git clone https://github.com/Jhackman2019/codebase-context-mcp.gitcd codebase-context-mcpnpm install && npm run buildclaude mcp add codebase-context -s user -- node /path/to/codebase-context-mcp/dist/index.js

MCP Settings (JSON)

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

LimitValue
Max files20,000
Max file size512KB
Default ignoresnode_modules, .git, dist, build, .venv, binaries, lock files
.gitignoreRespected (root level)

Development

bash
npm installnpm run build    # Build with tsupnpm run dev      # Watch modenpm start        # Run the server

License

MIT

Source: README.md at commit 6da2e54

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Codebase integrations

Codebase

design.codebaseOfficial publisher

Lets an AI agent build, preview and update web apps, download their source, and publish them when the user permits.

Streamable HTTPWeb executableAuth
Developer ToolsCredential requiredOct 24, 2026

Reactable Codebase Readiness Assessments

Published by GitHub account reactable-io

Remote MCP server that scores a codebase across 12 readiness areas, returning findings, fix prompts and re-assessment from inside an AI agent.

Streamable HTTPWeb executableAuth
Developer ToolsCredential requiredNov 4, 2026

Codebase Doctor

Published by GitHub account subhajitlucky

Read-only codebase auditor that lets a coding assistant scan a repository for secrets, dependency drift, RLS and auth issues, and get review verdicts with…

STDIODesktop only
Developer ToolsNot validated yetOct 24, 2026

Dsh Codebase Chat

Published by GitHub account shinzarou-eng

A local-first MCP server that answers questions about a codebase with cited evidence, plus audits and reports.

STDIODesktop only
Knowledge & MemoryNot validated yetOct 24, 2026

Codebase Chat

Published by GitHub account shinzarou-eng

Local-first codebase intelligence MCP server that lets an assistant chat about, search, audit and safely patch a repository with file-and-line citations.

STDIODesktop only
Knowledge & MemoryNot validated yetOct 24, 2026