开源仓库 MCP Server (ZRead MCP) 是一个基于模型上下文协议 (Model Context Protocol) 的开源仓库内容获取能力实现，基于 zread.ai 的强大能力，为 Claude Code, Cline 等兼容 MCP 的客户端提供开源仓库的知识文档与代码访问功能。 产品简介
此拥有开源仓库问答能力的 Remote MCP Server 是智谱为 GLM Coding Plan 用户开发的专属 Server, 让您的 Code Agent 能够深入理解开源项目，高效获取文档、代码结构与文件内容。
功能特性
文档搜索
Github 代码仓库检索文档、代码与注释
仓库结构
获取 GitHub 仓库的目录结构和文件列表，快速掌握项目布局
代码读取
读取 GitHub 仓库中指定文件的完整代码内容，深入分析实现细节
支持的工具
该服务器实现了模型上下文协议，可与任何兼容 MCP 的客户端一起使用。目前提供以下工具：
search_doc - 搜索 GitHub 仓库的对应的知识文档，快速了解仓库知识，新闻，最近的 issue pr 和贡献者等。get_repo_structure - 获取 GitHub 仓库的目录结构和文件列表，了解项目模块拆分和目录组织方式。read_file - 读取 GitHub 仓库中指定文件的完整代码内容，深入文件代码的实现细节。
示例场景
通过搜索文档和获取仓库结构，快速了解开源库的核心概念、安装步骤和代码组织方式，加速学习曲线。
在遇到问题时，搜索仓库的 Issue 和 Commit 历史，查找是否有类似问题的解决方案或修复记录。
直接读取核心文件的代码内容，分析实现逻辑，辅助进行二次开发或 Debug。
在引入新的依赖库之前，通过查看其仓库结构和文档，评估其活跃度、代码质量和维护情况。
安装与使用
快速开始
配置 MCP 服务器
根据您使用的客户端 参考下方 选择相应的配置方式
支持的客户端
Claude Code
Cline (VS Code)
OpenCode
Crush
Goose
Roo Code, Kilo Code 其它
一键安装命令注意替换里面的 your_api_key 为您上一步获取到的 API Keyclaude mcp add -s user -t http zread https://open.bigmodel.cn/api/mcp/zread/mcp --header "Authorization: Bearer your_api_key"
.claude.json 的 MCP 部分：{
"mcpServers": {
"zread": {
"type": "http",
"url": "https://open.bigmodel.cn/api/mcp/zread/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}
在 Cline 扩展设置中添加 MCP 服务器配置：注意替换里面的 your_api_key 为您上一步获取到的 API Key{
"mcpServers": {
"zread": {
"type": "streamableHttp",
"url": "https://open.bigmodel.cn/api/mcp/zread/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}
{
"mcpServers": {
"zread": {
"type": "sse",
"url": "https://open.bigmodel.cn/api/mcp/zread/sse?Authorization=your_api_key"
}
}
}
在 OpenCode 设置中添加 MCP 服务器配置：参考 OpenCode MCP 文档注意替换里面的 your_api_key 为您上一步获取到的 API Key{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"zread": {
"type": "remote",
"url": "https://open.bigmodel.cn/api/mcp/zread/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}
在 Crush 设置中添加 MCP 服务器配置：注意替换里面的 your_api_key 为您上一步获取到的 API Key{
"$schema": "https://charm.land/crush.json",
"mcp": {
"zread": {
"type": "http",
"url": "https://open.bigmodel.cn/api/mcp/zread/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}
在 Goose 设置中添加 MCP 服务器配置：点击 Extensions -> Add custom extension配置 Extension Name 为 zread，Type 选择 SSE，Endpoint 填写如下 URL：https://open.bigmodel.cn/api/mcp/zread/sse?Authorization=your_api_key
Add Extension 即可，注意替换里面的 your_api_key 为您上一步获取到的 API Key 对于 Roo Code, Kilo Code 等其它支持 MCP 协议的客户端，参考以下通用配置：注意替换里面的 your_api_key 为您上一步获取到的 API Key{
"mcpServers": {
"zread": {
"type": "streamable-http",
"url": "https://open.bigmodel.cn/api/mcp/zread/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}
MCP 使用额度说明
调用额度如下：
- Lite 套餐：联网搜索 MCP 和网页读取 MCP，ZRead MCP 每月合计 1 百次，达到上限后当月无法调用；视觉理解 MCP 共享套餐的 5 小时最大 prompt 资源池，达到上限后会在 5 小时周期后恢复额度。
- Pro 套餐：联网搜索 MCP 和网页读取 MCP，ZRead MCP 每月合计 1 千次，达到上限后当月无法调用；视觉理解 MCP 共享套餐的 5 小时最大 prompt 资源池，达到上限后会在 5 小时周期后恢复额度。
- Max 套餐：联网搜索 MCP 和网页读取 MCP，ZRead MCP 每月合计 4 千次，达到上限后当月无法调用；视觉理解 MCP 共享套餐的 5 小时最大 prompt 资源池，达到上限后会在 5 小时周期后恢复额度。
故障排除
问题： 收到访问令牌无效的错误解决方案：
- 确认访问令牌是否正确复制
- 检查访问令牌是否已激活
- 确认访问令牌是否有足够的余额
- 检查 Authorization header 格式是否正确
问题： MCP 服务器连接超时解决方案：
- 检查网络连接
- 确认防火墙设置
- 验证服务器 URL 是否正确
- 增加超时时间设置
问题： 无法搜索或读取指定仓库内容解决方案：
- 确认仓库是否存在且为开源（公开）仓库
- 检查仓库名称拼写是否正确 (owner/repo)
- 访问 zread.ai 搜索此开源仓库是否被收纳支持
相关资源
