代码研究MCP服务器
](https://smithery.ai/server/@nahmanmate/code-research-mcp-server)
一种模型上下文协议服务器,提供跨多个平台搜索和访问编程资源的工具。此服务器与流行的开发人员平台集成,以帮助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
