Code Research MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Search GitHub for both repositories and code examples through the search_github tool

  • Search MDN Web Docs for web development documentation through the search_mdn tool

  • Search npm registry for JavaScript packages through the search_npm tool

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

npx -y @smithery/cli install @nahmanmate/code-research-mcp-server --client claude

手动安装

  1. 克隆存储库并安装依赖项:
git clone https://github.com/nahmanmate/code-research-mcp-server.git cd code-research-server npm install
  1. 构建服务器:
npm run build
  1. 配置 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
{ "mcpServers": { "code-research": { "command": "node", "args": ["/absolute/path/to/code-research-mcp-server/build/index.js"], "env": { "GITHUB_TOKEN": "your_github_token" // Optional: Prevents rate limiting }, "disabled": false, "alwaysAllow": [] } } }

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

发展

以开发模式运行

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

npm run watch

错误处理

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

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

调试

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

npm run inspector

检查员提供:

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

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

缓存

使用node-cache缓存结果:

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

贡献

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

执照

AGPLv3

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

方便跨 Stack Overflow、MDN、GitHub、npm 和 PyPI 等平台搜索和访问编程资源,帮助 LLM 查找代码示例和文档。

  1. Features
    1. Integrated Platforms
    2. Tools
  2. Requirements
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Development
      1. Running in Development Mode
      2. Error Handling
      3. Debugging
      4. Caching
    3. Contributing
      1. License
        ID: 8ibodeufsz