🚀 代码研究 MCP 服务器
一个提供搜索和访问多个平台编程资源的模型上下文协议 (Model Context Protocol) 服务器。此服务器集成了流行开发者平台，帮助大语言模型（LLM）查找相关代码示例、文档和包。
🚀 快速开始
本服务器可助力大语言模型查找编程资源，以下为你介绍其使用步骤。
✨ 主要特性
集成平台
- Stack Overflow - 编程问答
- MDN Web Docs - 网页开发文档
- GitHub - 代码和仓库搜索
- npm - JavaScript 包注册表
- PyPI - Python 包索引
工具
search_stackoverflow
搜索 Stack Overflow 上的编程问题和答案。
- 参数：
query（必填）：搜索查询字符串limit（可选）：最大结果数（1 - 10，默认值：5）
- 返回：包含评分、回答数和摘录的格式化问题列表
- 结果缓存时间：1 小时
search_mdn
搜索 MDN Web 文档。
- 参数：
query（必填）：搜索查询字符串
- 返回：前 5 个 MDN 文档匹配项，包括摘要和链接
- 结果缓存时间：1 小时
search_github
搜索 GitHub 上的代码仓库或内容。
- 参数：
query（必填）：搜索查询字符串language（可选）：指定编程语言limit（可选）：最大结果数（1 - 10，默认值：5）
- 返回：包含仓库名称、描述和相关代码片段的列表
- 结果缓存时间：1 小时
search_npm
搜索 npm 上的包。
- 参数：
query（必填）：搜索查询字符串limit（可选）：最大结果数（1 - 10，默认值：5）
- 返回：包含包名称、版本和描述的列表
- 结果缓存时间：1 小时
search_pypi
搜索 PyPI 上的包。
- 参数：
query（必填）：搜索查询字符串limit（可选）：最大结果数（1 - 10，默认值：5）
- 返回：包含包名称、版本和描述的列表
- 结果缓存时间：1 小时
search_all
同时搜索所有平台。
- 参数：
query（必填）：搜索查询字符串limit（可选）：每个平台的最大结果数（1 - 10，默认值：5）
- 返回：包含来自所有平台的综合结果列表，按相关性排序
- 结果缓存时间：1 小时
📦 安装指南
自动安装 (通过 Smithery)
npm install -g @nahmanmate/code-research-mcp-server
手动安装
- 克隆仓库：
git clone https://github.com/nahmanmate/code-research-mcp-server.git
cd code-research-mcp-server
- 安装依赖：
npm install
📚 详细文档
配置
在 package.json 中配置默认参数，例如：
{
"github.token": "your_github_token",
"npm.email": "your_npm_email",
"pypi.endpoint": "https://pypi.org/pypi"
}
开发
运行开发模式
带有自动重建更改的功能：
npm run dev
错误处理
服务器实现强大的错误处理：
- 每个平台的特定错误消息
- GitHub API 的速率限制处理
- 服务不可用时的优雅 Fallback
- 缓存响应以减少 API 负载
调试
由于 MCP 服务器通过 stdio 通信，调试具有挑战性。使用 MCP Inspector 进行详细的请求/响应监视：
npm run debug
Inspector 提供：
- 实时请求/响应监视
- 工具执行跟踪
- 错误堆栈跟踪
- 性能指标
在浏览器中访问提供的 URL 以访问调试界面。
缓存
使用 node-cache 进行结果缓存：
- 默认过期时间：1 小时
- 每个查询/限制组合的独立缓存键
- 平台特定的缓存策略
- 内存高效存储
贡献
- 叉仓库
- 创建功能分支
- 提交更改
- 推送到分支
- 创建 Pull Request
📄 许可证
AGPLv3