Code Research MCP Server

🚀 代碼研究 MCP 服務器

一個提供搜索和訪問多種編程資源的 Model Context Protocol（模型上下文協議）服務器。該服務器集成多個流行開發者平臺，幫助大型語言模型（LLMs）查找相關代碼示例、文檔和包。

🚀 快速開始

本服務器可幫助大型語言模型查找相關代碼示例、文檔和包。你可以通過 Smithery 一鍵安裝，也能手動克隆倉庫進行安裝。安裝完成後，可根據需求配置 MCP 設置。

✨ 主要特性

集成平臺

• Stack Overflow - 編程問答社區
• MDN Web Docs - 網頁開發文檔
• GitHub - 代碼和倉庫搜索
• npm - JavaScript 包註冊表
• PyPI - Python 包索引

工具

search_stackoverflow

在 Stack Overflow 上搜索編程問題和答案。

• 參數：
  • query（必需）：搜索查詢字符串
  • limit（可選）：最大結果數（1 - 10，默認：5）
• 返回：包含評分、回答數和摘錄的格式化問題列表
• 結果緩存時間：1 小時

search_mdn

在 MDN Web Docs 上搜索網頁開發文檔。

• 參數：
  • query（必需）：搜索查詢字符串
• 返回：前 5 個 MDN 文檔匹配項，包含摘要和鏈接
• 結果緩存時間：1 小時

search_github

在 GitHub 上搜索代碼倉庫或用戶。

• 參數：
  • query（必需）：搜索查詢字符串
  • limit（可選）：最大結果數（1 - 10，默認：5）
• 返回：包含倉庫名稱、描述和星標數的列表
• 結果緩存時間：1 小時

search_npm

在 npm 上搜索 JavaScript 包。

• 參數：
  • query（必需）：搜索查詢字符串
  • limit（可選）：最大結果數（1 - 10，默認：5）
• 返回：包含包名稱、版本和描述的列表
• 結果緩存時間：1 小時

search_pypi

在 PyPI 上搜索 Python 包。

• 參數：
  • query（必需）：搜索查詢字符串
  • limit（可選）：最大結果數（1 - 10，默認：5）
• 返回：包含包名稱、版本和描述的列表
• 結果緩存時間：1 小時

📦 安裝指南

使用 Smithery 安裝

npx smithery install @nahmanmate/code-research-mcp-server

手動安裝

1. 克隆倉庫：

git clone https://github.com/yourusername/code-research-mcp-server.git
cd code-research-mcp-server

2. 安裝依賴：

npm install

3. 啟動服務器：

node index.js

配置 MCP 設置

在 package.json 中添加以下配置：

{
  "mcp": {
    "servers": {
      "code-research-mcp-server": {
        "command": "node index.js",
        "type": "stdio"
      }
    }
  }
}

📚 詳細文檔

開發

以開發模式運行

帶有自動重建功能：

npm run watch

錯誤處理

服務器實現穩健的錯誤處理：

• 每個平臺的 API 特定錯誤消息
• GitHub API 的速率限制處理
• 服務不可用時的優雅降級
• 緩存響應以減少 API 負載

調試

由於 MCP 服務器通過標準輸入/輸出進行通信，調試具有挑戰性。使用 MCP 檢查器進行詳細的請求/響應監控：

npm run inspector

檢查器提供：

• 即時請求/響應監控
• 工具執行跟蹤
• 錯誤堆棧跟蹤
• 性能指標

在瀏覽器中訪問提供的 URL 以獲取調試界面。

緩存

使用 node-cache 進行緩存：

• 默認 TTL：1 小時
• 每個查詢/限制組合的獨立緩存鍵
• 平臺特定的緩存策略
• 內存高效存儲

貢獻

1. 叉倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 創建拉取請求

📄 許可證

AGPLv3