Nahmanmate Code Research MCP Server

🚀 代碼研究 MCP 服務器

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

🚀 快速開始

本服務器可幫助大語言模型查找編程資源，下面為你介紹它的安裝、配置等使用步驟。

✨ 主要特性

集成平臺

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

工具

search_stackoverflow

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

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

search_mdn

搜索 MDN Web 文檔。

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

search_github

搜索 GitHub 上的代碼倉庫或內容。

• 參數：
  • query（必填）：搜索查詢字符串
  • language（可選）：指定編程語言
  • limit（可選）：最大結果數（1-10，默認值：5）
• 返回：包含倉庫名稱、描述和相關代碼片段的列表
• 結果緩存時間為 1 小時

search_npm

搜索 npm 上的包。

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

search_pypi

搜索 PyPI 上的包。

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

search_all

同時搜索所有平臺。

• 參數：
  • query（必填）：搜索查詢字符串
  • limit（可選）：每個平臺的最大結果數（1-10，默認值：5）
• 返回：包含來自所有平臺的綜合結果列表，按相關性排序
• 結果緩存時間為 1 小時

📦 安裝指南

自動安裝 (通過 Smithery)

npm install -g @nahmanmate/code-research-mcp-server

手動安裝

1. 克隆倉庫：

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

2. 安裝依賴：

   npm install
   

📚 詳細文檔

配置

在 package.json 中配置默認參數，例如：

{
  "github.token": "your_github_token",
  "npm.email": "your_npm_email",
  "pypi.endpoint": "https://pypi.org/pypi"
}

開發

運行開發模式

帶有自動重建更改的功能：

npm run dev

錯誤處理

服務器實現強大的錯誤處理：

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

調試

由於MCP服務器通過stdio通信，調試具有挑戰性。使用MCP Inspector進行詳細的請求/響應監視：

npm run debug

Inspector 提供：

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

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

緩存

使用 node-cache 進行結果緩存：

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

貢獻

1. 叉倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 創建Pull Request

📄 許可證

AGPLv3