Deepcontext MCP

🚀 大型代碼庫的智能上下文

DeepContext 是一個 MCP 服務器，它為 Codex CLI、Claude Code 等代碼編寫助手添加了支持符號感知的語義搜索功能，使它們即使在處理大型代碼庫時也能獲得更精確的上下文信息。目前支持 TypeScript 和 Python 語言。

🚀 快速開始

1. 訪問 Wildcard DeepContext 頁面。
2. 點擊“生成 API 密鑰”。
3. 複製你的 API 密鑰。
4. 為你的 MCP 客戶端粘貼安裝命令。
5. 輸入 index this codebase 對當前目錄進行索引。

Claude Code

claude mcp add deepcontext \
  -e WILDCARD_API_KEY=your-wildcard-api-key \
  -- npx @wildcard-ai/deepcontext@latest

Codex

# 添加到 ~/.codex/config.toml
[mcp_servers.deepcontext]
command = "npx"
args = ["-y", "@wildcard-ai/deepcontext@latest"]
env = { "WILDCARD_API_KEY" = "your-wildcard-api-key" }

💻 演示

點擊查看演示

✨ 為什麼選擇 DeepContext MCP？

大多數代碼編寫助手使用基於 grep 的精確文本匹配搜索，這種搜索方式會遺漏語義相關的代碼，並且會用不相關的結果填滿上下文窗口。在大型代碼庫中，這個問題會更加嚴重，因為文本搜索可能會返回數百個匹配項，很快就會超出對話容量。這會導致代碼補全速度變慢、出現更多幻覺內容以及成功率降低。

DeepContext 為代碼編寫助手提供智能搜索功能，通過僅查找相關代碼塊來保留上下文窗口。

• 語義準確性：通過代碼的含義和關係進行匹配，而不是基於文本模式，能夠找到跨文件的相關函數，這是關鍵字搜索所無法做到的。
• 減少令牌使用量：返回精確的代碼塊，而不是包含搜索詞的每個文件，從而保留對話上下文窗口並降低成本。
• 搜索速度快：通過預索引數據立即搜索代碼，實現即時文件發現。

📚 詳細文檔

MCP 工具

index_codebase

為你的代碼庫創建可搜索的索引，以便進行語義搜索。

search_codebase

使用自然語言或關鍵字查詢查找相關代碼。

get_indexing_status

顯示代碼庫的索引狀態和文件數量。

clear_index

刪除代碼庫的所有索引數據。

架構

MCP 集成流程

• 代碼編寫助手通過模型上下文協議與 DeepContext 進行通信。
• MCP 服務器接收請求，驗證參數，並將其路由到適當的核心組件。
• 對於像索引這樣的長時間運行操作，會生成獨立的後臺進程以防止超時。
  • 後臺工作進程可以處理大型代碼庫，而不會阻塞 MCP 通道。

基於 AST 的解析

• Tree-sitter 解析器分析源代碼以構建抽象語法樹。
  • 支持 Python、TypeScript 和 JavaScript 語言語法，以實現準確解析。
  • 對函數、類、接口和模塊進行語義節點識別。
• 符號提取識別函數、類、接口、類型、變量和常量。
  • 作用域分析確定局部、導出和全局可見性。
  • 提取函數簽名中的參數和返回類型。
• 導入/導出分析映射模塊依賴關係和跨文件關係。
• 在語義邊界處創建代碼塊，而不是任意的行或令牌分割。
  • 通過基於範圍的解析和重疊窗口處理大文件。

帶重排序的混合搜索

• 搜索操作分為三個階段。
  • 混合搜索結合了向量相似度和 BM25 全文搜索。
  • 使用 Jina reranker-v2 進行最終相關性優化。
• 向量相似度使用嵌入查找語義相關的代碼。
  • Jina 文本嵌入為代碼塊生成 1024 維向量。
• BM25 執行傳統的關鍵字匹配以查找精確術語。
  • 全文索引支持精確的標識符和註釋匹配。
• 使用可配置的權重融合結果，然後由 Jina 重排器重新排序。

增量索引

• 使用文件修改時間和內容哈希來跟蹤更改。
  • SHA-256 哈希在字節級別檢測內容修改。
• 在重新索引期間，僅重新處理哈希不同的文件。
  • 避免對未更改的文件進行不必要的解析和嵌入生成。

內容過濾

• 根據文件擴展名模式、路徑組件和內容分析對文件進行評分。
  • 進行語言檢測和文件類型分類，以做出處理決策。
• 在索引期間排除測試文件、生成的代碼、壓縮文件和構建輸出。
  • 對常見測試框架和構建工具輸出進行模式匹配。
• 過濾文檔和配置文件，專注於源代碼。

📦 自託管

自託管需要對代碼進行修改，以直接與向量存儲和嵌入提供程序集成，因為當前實現使用 Wildcard API 後端。

前提條件

• Node.js 20+，以支持 ES 模塊並進行性能優化。
• Turbopuffer API 密鑰，用於向量存儲和混合搜索操作。
• Jina AI API 密鑰，用於文本嵌入和重排序服務。

安裝步驟

git clone https://github.com/Wildcard-Official/deepcontext-mcp.git
cd deepcontext
npm install
npm run build

集成步驟

claude mcp add deepcontext-local \
  -e TURBOPUFFER_API_KEY=your-turbopuffer-key \
  -e JINA_API_KEY=your-jina-key \
  -- node /path/to/deepcontext/dist/standalone-mcp-integration.js

🤝 貢獻代碼

感謝你的關注！由於我們是一家處於早期階段的初創公司，專注於快速迭代，目前暫不接受外部貢獻。我們可能會在未來開放貢獻渠道 —— 你可以給倉庫點個 ⭐ 以保持關注。

📄 許可證

本項目採用 Apache 許可證。