代码研究MCP服务器
一种模型上下文协议服务器，提供跨多个平台搜索和访问编程资源的工具。此服务器与流行的开发人员平台集成，以帮助LLM找到相关的代码示例、文档和包。
特性
集成平台
- 堆栈溢出-编程问答
- MDN Web文档-Web开发文档
- GitHub-代码和存储库搜索
- npm-JavaScript包注册表
- PyPI-Python包索引
工具
search_stackoverflow
在Stack Overflow中搜索编程问题和答案。
- 参数：
- query （必填）：搜索查询字符串 - limit （可选）：最大结果（1-10，默认值：5）
- 返回：包含分数、答案计数和摘录的格式化问题列表
- 结果缓存1小时
search_mdn
在MDN Web文档中搜索Web开发文档。
- 参数：
- query （必填）：搜索查询字符串
- 返回：前5个MDN文档与摘要和链接匹配
- 结果缓存1小时
search_github
在GitHub上搜索存储库和代码示例。
- 参数：
- query （必填）：搜索查询字符串 - language （可选）：按编程语言筛选 - limit （可选）：每个类别的最大结果数（1-10，默认值：5）
- 返回：两部分：
1. 按星级排序的顶级存储库 1. 具有存储库上下文的相关代码文件
- 结果缓存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问答 1. MDN文档 1. GitHub存储库和代码 1. npm包 1. PyPI包
- 结果缓存1小时
- 注意：并行执行所有搜索以获得更快的响应
需求
- Node.js>=20.11.0
- npm>=10.0.0
- 可选：用于更高API速率限制的GitHub个人访问令牌
安装
通过Smithery安装
通过以下方式自动安装克劳德桌面代码研究服务器 史密瑟里:
npx -y @smithery/cli install @nahmanmate/code-research-mcp-server --client claude手动安装
- 克隆存储库并安装依赖项：
git clone https://github.com/nahmanmate/code-research-mcp-server.git
cd code-research-server
npm install- 构建服务器：
npm run build- 配置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 - 窗户： %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检查器进行详细的请求/响应监控：
npm run inspector检查员提供：
- 实时请求/响应监控
- 工具执行跟踪
- 错误堆栈跟踪
- 性能指标
访问浏览器中提供的URL以访问调试界面。
缓存
使用缓存结果 node-cache:
- 默认TTL：1小时
- 每个查询/限制组合都有单独的缓存键
- 特定于平台的缓存策略
- 内存高效存储
贡献
- 分叉存储库
- 创建要素分支
- 提交您的更改
- 推到分支
- 创建拉取请求
许可证
AGPLv3