开源仓库 MCP - 智谱AI开放文档

开源仓库 MCP Server（ZRead MCP）是智谱为 GLM Coding Plan 用户开发的专属 Remote MCP Server，基于模型上下文协议（Model Context Protocol）和 zread.ai 能力，可为 Claude Code、Cline 等兼容 MCP 的客户端提供开源仓库知识文档、代码结构与文件内容访问能力。

功能特性

文档搜索

Github 代码仓库检索文档、代码与注释

仓库结构

获取 GitHub 仓库的目录结构和文件列表，快速掌握项目布局

代码读取

读取 GitHub 仓库中指定文件的完整代码内容，深入分析实现细节

支持的工具

该服务器实现了模型上下文协议，可与任何兼容 MCP 的客户端一起使用。目前提供以下工具：

search_doc - 搜索 GitHub 仓库的对应的知识文档，快速了解仓库知识，新闻，最近的 issue pr 和贡献者等。
get_repo_structure - 获取 GitHub 仓库的目录结构和文件列表，了解项目模块拆分和目录组织方式。
read_file - 读取 GitHub 仓库中指定文件的完整代码内容，深入文件代码的实现细节。

示例场景

快速上手开源库

通过搜索文档和获取仓库结构，快速了解开源库的核心概念、安装步骤和代码组织方式，加速学习曲线。

排查 Issue 和历史记录

在遇到问题时，搜索仓库的 Issue 和 Commit 历史，查找是否有类似问题的解决方案或修复记录。

深入源码分析

直接读取核心文件的代码内容，分析实现逻辑，辅助进行二次开发或 Debug。

依赖库调研

在引入新的依赖库之前，通过查看其仓库结构和文档，评估其活跃度、代码质量和维护情况。

安装与使用

快速开始

获取访问令牌

个人版套餐的用户，通过个人编程套餐 > 套餐概览，新建 API Key
团队版套餐的成员，通过团队编程套餐 > 我的套餐，获取 API Key（团队套餐 Key 与平台其他 API Key 不通用，使用团队额度请务必使用团队套餐 Key）

配置 MCP 服务器

根据您使用的客户端 参考下方 选择相应的配置方式

支持的客户端

一键安装命令注意替换里面的 your_api_key 为您上一步获取到的 API Key

claude mcp add -s user -t http zread https://open.bigmodel.cn/api/mcp/zread/mcp --header "Authorization: Bearer your_api_key"

手动配置编辑 Claude Code 的配置文件, 位于用户目录下 .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"
      }
    }
  }
}

若老版本 Cline 不支持 StreamableHttp 类型的 MCP 服务器，可以使用 SSE 类型的配置：

{
  "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 不支持，详见 Issue在 Goose 设置中添加 MCP 服务器配置：点击 Extensions -> Add custom extension配置 Extension Name 为 zread，Type 选择 HTTP，Endpoint 填写如下 URL：

https://open.bigmodel.cn/api/mcp/zread/mcp

配置 Request Headers 添加 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"
      }
    }
  }
}

故障排除

访问令牌无效

问题： 收到访问令牌无效的错误解决方案：

确认访问令牌是否正确复制
检查访问令牌是否已激活
确认访问令牌是否有足够的余额
检查 Authorization header 格式是否正确

连接超时

问题： MCP 服务器连接超时解决方案：

检查网络连接
确认防火墙设置
验证服务器 URL 是否正确
增加超时时间设置

仓库访问失败

问题： 无法搜索或读取指定仓库内容解决方案：

确认仓库是否存在且为开源（公开）仓库
检查仓库名称拼写是否正确 (owner/repo)
访问 zread.ai 搜索此开源仓库是否被收纳支持

​功能特性

文档搜索

仓库结构

代码读取

​支持的工具

​示例场景

​安装与使用

​快速开始

​支持的客户端

​故障排除

​相关资源