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