Code Context MCP

🚀 代碼上下文MCP服務器

代碼上下文MCP服務器是一個提供來自本地Git倉庫代碼上下文的模型上下文協議（MCP）服務器。它能夠讓您在本地克隆Git倉庫、處理分支和文件、為代碼片段生成嵌入，還能在代碼上執行語義搜索，為代碼處理和搜索提供了便捷的解決方案。

🚀 快速開始

此服務器允許您進行以下操作：

1. 本地克隆Git倉庫
2. 處理分支和文件
3. 為代碼片段生成嵌入
4. 在代碼上執行語義搜索

✨ 主要特性

• 使用本地Git倉庫而不是GitHub API，避免了API的限制和調用成本。
• 將數據存儲在SQLite數據庫中，方便數據的管理和維護。
• 將代碼分割為語義塊，有助於更精準地處理和搜索代碼。
• 使用Ollama生成代碼片段的嵌入，提升嵌入生成的效率和質量。
• 提供對代碼的語義搜索，讓您更輕鬆地找到所需代碼。

📦 安裝指南

先決條件

• Node.js (v16+)
• Git
• 帶有嵌入式模型的Ollama

安裝步驟

# 克隆倉庫
git clone <repository-url>
cd code-context-mcp

# 安裝依賴項
npm install

# 構建項目
npm run build

📚 詳細文檔

配置

設置以下環境變量：

• DATA_DIR：SQLite數據庫目錄（默認：~/.codeContextMcp/data）
• REPO_CACHE_DIR：克隆的倉庫目錄（默認：~/.codeContextMcp/repos）

使用Ollama

為了更快且更強大的嵌入，您可以使用Ollama：

# 從https://ollama.ai/安裝Ollama

# 拉取一個嵌入模型（unclemusclez/jina-embeddings-v2-base-code推薦）
ollama pull unclemusclez/jina-embeddings-v2-base-code

使用方法

與Claude Desktop一起使用

將以下配置添加到您的Claude Desktop配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "code-context-mcp": {
      "command": "/path/to/your/node",
      "args": ["/path/to/code-context-mcp/dist/index.js"]
    }
  }
}

工具

服務器提供以下工具：

queryRepo

克隆倉庫，處理代碼，並執行語義搜索：

{
  "repoUrl": "https://github.com/username/repo.git",
  "branch": "main", // 可選 - 默認為倉庫的默認分支
  "query": "您的搜索查詢",
  "keywords": ["keyword1", "keyword2"], // 可選 - 按關鍵字過濾結果
  "filePatterns": ["**/*.ts", "src/*.js"], // 可選 - 使用glob模式過濾文件
  "excludePatterns": ["**/node_modules/**"], // 可選 - 排除文件的glob模式
  "limit": 10 // 可選 - 結果數量，默認為10
}

調試

針對Mac M系列芯片的ARM架構問題：

# 嘗試以下命令：
curl http://localhost:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://127.0.0.1:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'
curl http://[::1]:11434/api/embed -d '{"model":"unclemusclez/jina-embeddings-v2-base-code","input":"Llamas are members of the camelid family"}'

📄 許可證

本項目採用MIT許可證。