Zread MCP

Zread.ai MCP Server

连接 Zread.ai 文档平台的 MCP 服务器，让 AI 助手能够阅读 GitHub 仓库文档、搜索代码、与仓库 AI 对话。

💡 提示 AI：这是一个 MCP (Model Context Protocol) 服务器，提供 9 个工具用于代码仓库分析。支持 Python 和 Node.js 两种实现，可通过 npx 或 uvx 一行命令运行。核心功能包括文档查询、仓库搜索、AI 问答。

功能

• 文档查询 - 获取仓库文档页面、目录结构、搜索关键词
• 仓库发现 - 推荐仓库、热门榜单、搜索代码库
• AI 问答 - 向仓库 AI 助手提问（需 Token）
• 文件获取 - 读取源代码文件内容（需 Token）

快速启动

uvx zread-mcp

npx zread-mcp

带 Token 运行

# uvx (Python)

uvx --env ZREAD_TOKEN=your-token zread-mcp

npx (Node.js) - Windows

set ZREAD_TOKEN=your-token && npx zread-mcp

npx (Node.js) - macOS/Linux

ZREAD_TOKEN=your-token npx zread-mcp

HTTP 模式 (Streamable HTTP)

uvx zread-mcp --transport http --port 3000

npx zread-mcp --transport http --port 3000

---

更多运行方式

Python 生态

# uvx 从 PyPI 运行（推荐）

uvx zread-mcp

uvx 从 GitHub 仓库运行

uvx --from git+https://github.com/ejfkdev/zread-mcp.git zread-mcp

uv 运行远程脚本

uv run https://raw.githubusercontent.com/ejfkdev/zread-mcp/main/zread_mcp_server.py

pipx 从 GitHub 运行

pipx run --spec git+https://github.com/ejfkdev/zread-mcp.git zread-mcp

pipx 安装到本地

pipx install git+https://github.com/ejfkdev/zread-mcp.git zread-mcp --transport http

本地运行

python zread_mcp_server.py

Node.js 生态

# pnpm

pnpm dlx ejfkdev/zread-mcp

bun

bunx ejfkdev/zread-mcp

全局安装

npm install -g ejfkdev/zread-mcp zread-mcp-server --transport http

MCP 客户端配置

npx（Node.js）

{

"mcpServers": { "zread": { "command": "npx", "args": ["-y", "zread-mcp-server"], "env": { "ZREAD_TOKEN": "your-token" } } } }

uvx（Python）

{

"mcpServers": { "zread": { "command": "uvx", "args": ["--env", "ZREAD_TOKEN=your-token", "zread-mcp"] } } }

获取 Token

部分高级功能（AI 问答、文件获取）需要 ZREAD_TOKEN：

1. 访问 https://zread.ai 并登录
2. 按 F12 打开控制台
3. 粘贴运行：

   prompt('复制token', JSON.parse(localStorage.getItem('CGX_AUTH_STORAGE')).state.token)

1. 复制弹窗中的 Token

命令行参数

--transport {stdio,http,sse}  传输协议 (默认: stdio, http/sse 等价)

--host HOST HTTP 模式主机 (默认: 127.0.0.1) --port PORT HTTP 模式端口 (默认: 3000) --token TOKEN ZREAD_TOKEN --no-token 强制无 Token 模式 -h, --help 显示帮助

工具列表

开发

# 克隆仓库

git clone https://github.com/ejfkdev/zread-mcp.git cd zread-mcp

Python 测试

python zread_mcp_server.py --test

Node.js 测试

node zread-mcp-server.js --test

许可证

MIT License