代码研究 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