Codebase Context MCP

🚀 代码库上下文MCP（codebase-context-mcp）

适用于代码库索引和搜索的MCP服务器，可在所有平台上运行 — 包括树莓派和苹果硅芯片等ARM64设备，而大多数其他替代方案在这些设备上会失败。

🚀 快速开始

本项目是一个适用于代码库索引和搜索的MCP服务器，可在所有平台运行，尤其解决了ARM64设备上代码库索引MCP服务器安装失败的问题。

安装方式

Claude Code（推荐）

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

或者从本地克隆安装：

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设置（JSON）

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

✨ 主要特性

• 跨平台支持：可在包括ARM64设备（如树莓派、苹果硅芯片Mac、AWS Graviton等）和x86_64设备的任何架构上运行，解决了原生依赖在ARM64设备上安装失败的问题。
• 零原生依赖：用WASM等效方案替代了所有原生依赖，npm install 首次尝试即可在任何架构上成功。
• 即插即用兼容性：通过标准的MCP stdio传输提供相同的核心工具（索引、搜索、大纲、摘要）。

📦 安装指南

Claude Code（推荐）

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

或者从本地克隆安装：

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设置（JSON）

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

💻 使用示例

本项目提供了一系列工具，可用于代码库的索引、搜索等操作。以下是各工具的说明：

📚 详细文档

支持的语言

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

工作原理

• 解析：使用web-tree-sitter（WASM），与原生tree-sitter具有相同的AST质量，可在任何架构上运行。
• 搜索：采用BM25文本排名（纯JS） + 符号名称匹配。
• 存储：JSON文件索引存储在~/.codebase-context-mcp/<project-hash>.json。
• 传输：通过@modelcontextprotocol/sdk进行MCP stdio传输。
• 增量更新：重新索引时跳过内容哈希未改变的文件。

安全限制

开发

npm install
npm run build    # 使用tsup构建
npm run dev      # 监听模式
npm start        # 运行服务器

📄 许可证

本项目采用MIT许可证。