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許可證。