io.github.ejfkdev/zread-mcp
NPM · ZREAD-MCP · SCANNED AUG 3
Zread.ai MCP Server - 连接 zread.ai 文档平台的 MCP 服务器，让 AI 助手能够阅读 GitHub 仓库文档、搜索代码、与仓库 AI 对话。
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security87
- No malware found by supply-chain analysis.Pass
- Only part of the dependency tree could be resolved (122 of 124), so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (122 of 124), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 142 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability45
- 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Fail
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 790 tokens (~98/item across 8 items; 7 tools + 1 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · zread-mcp
claude mcp add ejfkdev-zread-mcp -- npx -y zread-mcp
codex mcp add ejfkdev-zread-mcp -- npx -y zread-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ejfkdev-zread-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"zread-mcp"
],
"enabled": true
}
}
} openclaw mcp add ejfkdev-zread-mcp --command npx --arg -y --arg zread-mcp
mcp_servers:
ejfkdev-zread-mcp:
command: "npx"
args: ["-y", "zread-mcp"] {
"mcpServers": {
"ejfkdev-zread-mcp": {
"command": "npx",
"args": [
"-y",
"zread-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +40
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → good ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
- 1 Aug 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
- 29 Jul 26 +19
- Dependency health: partial → unverified ▼ functional
- Schema quality: unverified → 0 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- 28 Jul 26 −19
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 0 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- 27 Jul 26 44
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 122 packages
122 packages in the resolved dependency tree · 122 deprecated · 35 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
check_repository_status ~72
检查仓库索引状态。 查询指定仓库在 Zread.ai 的索引状态和基本信息。 返回的 status 字段: "success"(已索引), "progress"(索引中)
| Name | Type | Req | Description |
|---|---|---|---|
| repo_path | string | yes | 仓库路径，格式: owner/repo |
No output schema declared.
No examples provided.
discover_repositories ~71
发现推荐的代码仓库。 获取 Zread.ai 推荐的优质代码仓库，可按技术主题筛选。 适用于发现新工具、学习优秀项目。
| Name | Type | Req | Description |
|---|---|---|---|
| topic | string | — | 技术主题筛选，如 "ai", "python", "web"，空字符串表示全部 |
No output schema declared.
No examples provided.
fetch_documentation_page ~300
获取仓库文档的指定页面内容。 根据页面 slug（URL 标识符）获取该页面的完整 Markdown 文档内容。 适用于读取特定章节或页面的详细内容。 返回的 Markdown 页面内容中可能包含两种链接格式： 1. **仓库文件链接** - 格式: `[文件名](文件路径#L开始行号-L结束行号)` 例如: `[index.ts](index.ts#L1-L28)` `[package.json](package.json#L1-L77)` 这类链接指向仓库内的源代码文件，可提取文件路径和行号范围， 使用 `fetch_repository_file(repo_path, file_path, start_line, end_line)` 获取具体内容。 2. **文档导航链接** - 格式: `[标题](页面slug)` 例如: `[概述](1-overview)` `[快速开始](2-quick-start)` 这类链接指向文档的其他页面，使用 `fetch_documentation_page(repo_path, 页面slug)` 获取该页文档内容。
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | 文档语言，可选 "zh"(中文) 或 "en"(英文) |
| page_slug | string | yes | 页面 slug，如 "1-overview", "quick-start" |
| repo_path | string | yes | 仓库路径，格式: owner/repo 或完整 URL |
No output schema declared.
No examples provided.
find_repositories ~80
搜索代码仓库。 根据关键词模糊搜索已索引的代码仓库。 支持仓库名称、描述、主题等字段的模糊匹配。
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | 返回语言，可选 "zh" 或 "en" |
| query | string | yes | 搜索关键词，如 "react", "machine learning" |
No output schema declared.
No examples provided.
get_documentation_outline ~100
获取仓库文档的完整目录结构。 返回仓库的文档目录树，包含所有页面的标题、slug 和层级关系。 首次调用会自动提交索引请求，如果仓库未被索引会返回等待状态。
| Name | Type | Req | Description |
|---|---|---|---|
| language | string | — | 文档语言，可选 "zh" 或 "en" |
| repo_path | string | yes | 仓库路径，格式: owner/repo 或完整 URL |
No output schema declared.
No examples provided.
get_trending_repositories ~48
获取本周热门仓库榜单。 获取 GitHub 本周最受欢迎的代码仓库列表，按热度排序。 适用于了解技术趋势和热门项目。
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
search_documentation ~105
在仓库文档中搜索关键词。 全文搜索仓库文档，返回包含关键词的页面和相关内容片段。 适用于快速定位文档中的特定信息。
| Name | Type | Req | Description |
|---|---|---|---|
| keyword | string | yes | 搜索关键词，如 "installation", "API", "config" |
| language | string | — | 搜索语言，可选 "zh" 或 "en" |
| repo_path | string | yes | 仓库路径，格式: owner/repo 或完整 URL |
No output schema declared.
No examples provided.