Code Search MCP

🚀 代碼搜索MCP服務器

這是一款面向AI智能體的高性能、批量處理的MCP（模型上下文協議）代碼理解工具包，特別針對Java進行了優化。它旨在解決AI智能體在大型代碼庫中“迷失方向”或缺乏精確上下文的難題，專注於深度解析、並行批量處理和全景上下文，能夠高效探索大型代碼庫，顯著減少令牌使用量，同時提升邏輯理解能力。

🚀 快速開始

本工具包專為解決AI智能體在大型代碼庫中的難題而設計，通過深度解析、並行批量處理和全景上下文等技術，幫助AI智能體更高效地理解代碼。

✨ 主要特性

使用場景

• 全景上下文：一次調用即可讀取多個文件，並自動擴展依賴上下文。
• 結構映射：藉助對Java註解的深度理解，快速構建項目大綱。
• 精準定位：精準定位類、方法和定義，並批量返回結果。

核心工具

設計要點

• 標準輸入輸出傳輸：通過標準輸入輸出使用JSON - RPC 2.0協議。
• 確定性協議：僅使用絕對路徑，不支持路徑通配符。
• Java大綱增強：將註解回溯合併到簽名中。

Java Spring深度適配

本工具不僅僅是文本搜索，還能理解業務邏輯：

• 分層感知排序：智能排序（控制器 → 服務 → 實現 → 消息隊列 → 倉庫），讓AI能立即理解業務流程。
• 深度註解感知：AI不僅能看到簽名，還能看到合併後的註解（如@Transactional、@PreAuthorize），從而理解業務語義。
• 智能依賴注入解析：自動識別注入字段（依賴項），無需AI猜測userService的來源。
• 項目結構支持：全面支持src/main/java和多模塊Maven/Gradle項目。

📦 安裝指南

環境要求

• Node.js v18.0.0或更高版本

安裝與構建

npm install
npm run build

💻 使用示例

集成示例

"mcpServers": {
  "code-search": {
    "command": "node",
    "args": ["{file}/code-search/index.js"]
  }
}

📚 詳細文檔

使用提示

• 優先選擇：若需要一次性獲取完整上下文，建議使用view_files_full_context。
• 路徑要求：為確保穩定性和可重複性，請使用絕對路徑。
• 複雜查詢：複雜查詢應拆分為精確調用。

📄 許可證

本項目採用MIT許可證進行開源。你可以在許可證條款的規定下使用、修改和分發該項目。