Zread MCP
What it does
Zread.ai MCP Server - 连接 zread.ai 文档平台的 MCP 服务器,让 AI 助手能够阅读 GitHub 仓库文档、搜索代码、与仓库 AI 对话。
- Connects パソコンで動く
- Account or key Needs ZREAD_TOKEN
- Category 開発者ツール
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 2/3 合格 · あなたのパソコンで動きます
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
Zread MCP に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
パソコン版 Claude アプリの設定ファイルを開く
SettingsDeveloperEdit Config
この設定を貼り付けて保存
{ "mcpServers": { "zread": { "command": "npx", "args": [ "-y", "zread-mcp" ], "env": { "ZREAD_TOKEN": "your-value" } } } }キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude を終了してもう一度開く
試してみる
Zread MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Zread MCP を使っていると言うか、回答に Zread MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ Zread MCP につなげません
Zread MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
代わりにできること
A · Zread MCP につなげるアプリを使う
- Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
- Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
- Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
B · 開発者ツール の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Claude Code につなげますが、先に準備が必要です
Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Zread MCP に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --scope user zread --env ZREAD_TOKEN=your-value -- npx -y zread-mcpEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Claude Code で /mcp と入力
Zread MCP が一覧にあり、接続済みと表示されれば OK です
試してみる
Zread MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Zread MCP を使っていると言うか、回答に Zread MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Zread MCP に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
Zread MCP の設定で ZREAD_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
Cursor の AI チャットを Agent モードで開く
試してみる
Zread MCP を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Zread MCP を使っていると言うか、回答に Zread MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
Zread MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Node.js を入れてください(1 回だけ)
Zread MCP に登録してキーを作る
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
キーを入力
Zread MCP の設定で ZREAD_TOKEN が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
VS Code の AI チャットを Agent モードで開く
試してみる
Zread MCP を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Zread MCP を使っていると言うか、回答に Zread MCP のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
パソコンにインストール
Claude Code
claude mcp add --scope user zread --env ZREAD_TOKEN=your-value -- npx -y zread-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"zread": {
"command": "npx",
"args": [
"-y",
"zread-mcp"
],
"env": {
"ZREAD_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"zread": {
"command": "npx",
"args": [
"-y",
"zread-mcp"
],
"env": {
"ZREAD_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"zread": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zread-mcp"
],
"env": {
"ZREAD_TOKEN": "your-value"
}
}
}
}自分で入力する値
ZREAD_TOKEN秘密 envYour API key for the service
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
ひと目でわかる
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
できること
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月12日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント ejfkdev で確認済みです
- ✕ 不合格
今もメンテナンスされている
1年以上コードの更新がないか、リポジトリがアーカイブされています
- ✓ 合格
ライセンスがある
MITを使用
- – 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
- – 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
- … 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの5810件のうち77%よりスターが多い
- このカテゴリのほかの5810件のうち5%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5810件のうち38%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Zread MCPは安全ですか?
当てはまる基本チェック3項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:ZREAD_TOKEN
パソコンで動きますか、それともクラウドですか?
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は8 か月前、最新バージョン(1.0.1)がレジストリに届いたのは8 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリのほかの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
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:
- 访问 https://zread.ai 并登录
- 按 F12 打开控制台
- 粘贴运行:
prompt('复制token', JSON.parse(localStorage.getItem('CGX_AUTH_STORAGE')).state.token)
- 复制弹窗中的 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 显示帮助
工具列表
| 工具 | 需要 Token | 说明 |
|---|---|---|
| fetch_documentation_page | 否 | 获取文档页面 |
| search_documentation | 否 | 搜索文档 |
| get_documentation_outline | 否 | 获取文档大纲 |
| discover_repositories | 否 | 发现推荐仓库 |
| find_repositories | 否 | 搜索仓库 |
| get_trending_repositories | 否 | 热门仓库榜单 |
| check_repository_status | 否 | 检查仓库状态 |
| ask_repo_ai | 是 | AI 智能问答 |
| fetch_repository_file | 是 | 获取源代码文件 |
开发
# 克隆仓库
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