代码研究 MCP 服务器

一个提供搜索和访问多种编程资源的 Model Context Protocol（模型上下文协议）服务器。该服务器集成多个流行开发者平台，帮助大型语言模型（LLMs）查找相关代码示例、文档和包。

功能

集成平台

• 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