Code Research MCP Server

代码研究 MCP 服务器

模型上下文协议 (MCP) 服务器提供跨多个平台搜索和访问编程资源的工具。该服务器与主流开发者平台集成，帮助法学硕士 (LLM) 找到相关的代码示例、文档和软件包。

特征

集成平台

• Stack Overflow - 编程问答
• MDN Web Docs - Web 开发文档
• GitHub - 代码和存储库搜索
• npm——JavaScript 包注册中心
• PyPI——Python 包索引

工具

search_stackoverflow

在 Stack Overflow 上搜索编程问题和答案。

• 参数：
  • query （必需）：搜索查询字符串
  • limit （可选）：最大结果数（1-10，默认值：5）
• 返回：带有分数、答案计数和摘录的格式化问题列表
• 结果缓存 1 小时

search_mdn

在 MDN Web Docs 中搜索 Web 开发文档。

• 参数：
  • query （必需）：搜索查询字符串
• 返回：前 5 个 MDN 文档匹配，包含摘要和链接
• 结果缓存 1 小时

search_github

在 GitHub 上搜索存储库和代码示例。

• 参数：
  • query （必需）：搜索查询字符串
  • language （可选）：按编程语言过滤
  • limit （可选）：每个类别的最大结果数（1-10，默认值：5）
• 返回：两部分：
  1. 按星号排序的顶级存储库
  2. 具有存储库上下文的相关代码文件
• 结果缓存 1 小时

search_npm

在 npm 注册表中搜索 JavaScript 包。

• 参数：
  • query （必需）：搜索查询字符串
  • limit （可选）：最大结果数（1-10，默认值：5）
• 返回：软件包信息，包括版本、描述和下载统计信息
• 结果缓存 1 小时

search_pypi

在 PyPI 中搜索 Python 包。

• 参数：
  • query （必需）：搜索查询字符串
• 返回：详细的包信息，包括版本、作者和链接
• 结果缓存 1 小时

search_all

同时搜索所有平台以获得全面的结果。

• 参数：
  • query （必需）：搜索查询字符串
  • limit （可选）：每个平台的最大结果数（1-5，默认值：3）
• 返回：所有平台的综合结果：
  1. Stack Overflow 问题和答案
  2. MDN 文档
  3. GitHub 存储库和代码
  4. npm 包
  5. PyPI 软件包
• 结果缓存 1 小时
• 注意：并行执行所有搜索以获得更快的响应

要求

• Node.js >= 20.11.0
• npm >= 10.0.0
• 可选：GitHub 个人访问令牌，用于更高的 API 速率限制

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Code Research Server：

手动安装

1. 克隆存储库并安装依赖项：

2. 构建服务器：

3. 配置 MCP 设置：

将服务器配置添加到您的 MCP 设置文件：

• VSCode： ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• 克劳德桌面：
  • MacOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows： %APPDATA%/Claude/claude_desktop_config.json

注意：将/absolute/path/to替换为您克隆存储库的实际路径。

发展

以开发模式运行

对于发生更改时自动重建的开发：

错误处理

服务器实现了强大的错误处理：

• 每个平台的 API 特定错误消息
• GitHub API 的速率限制处理
• 服务不可用时的优雅回退
• 缓存响应以减少 API 负载

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。您可以使用 MCP Inspector 来详细监控请求/响应：

检查员提供：

• 实时请求/响应监控
• 工具执行追踪
• 错误堆栈跟踪
• 性能指标

在浏览器中访问提供的 URL 以访问调试界面。

缓存

使用node-cache缓存结果：

• 默认 TTL：1 小时
• 每个查询/限制组合单独的缓存键
• 特定于平台的缓存策略
• 内存高效存储

贡献

1. 分叉存储库
2. 创建功能分支
3. 提交你的更改
4. 推送到分支
5. 创建拉取请求

执照

AGPLv3