关于 GitHub Release MCP
GitHub Release MCP 是供 Agent 检索 GitHub Release 资源的 Python MCP 服务,支持经多个镜像并行分段下载,并在可用时校验资源的 SHA-256 摘要。
主要功能
- 01列出 Release 资源
- 02按名称或 glob 模式下载资源
- 03通过多个镜像并行分段下载
- 04在可用时校验 SHA-256
- 05仅使用 Python 标准库
适用场景
- 01查看 GitHub Release 中的资源
- 02在网络受限环境下载指定文件
- 03依据发布的摘要检查下载文件
MCP 相关
该服务通过 MCP stdio 通信,提供列出和下载 GitHub Release 资源的工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
2收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tag | string | 否 | 发布标签;省略或使用 'latest' 表示最新版本。 |
| repo | string | 是 | 仓库名称,例如 ghidra |
| owner | string | 是 | 仓库所有者,例如 NationalSecurityAgency |
详细介绍
gh-release-mcp
一个 MCP 服务,可让 Agent 列出并下载 GitHub 发布资源,支持多镜像并行分段下载和 sha256 校验。无需外部二进制文件(纯 Python 标准库:不需要
aria2、curl、gh、jq)。由 embedai.com.cn 提供。
专为受限网络打造:它会探测哪些镜像支持 HTTP Range(206),将文件分段并通过多个镜像并行下载,然后使用 GitHub 自身资源的 digest 校验 sha256。
工具
| 工具 | 功能 |
|---|---|
list_release_assets | 列出某个发布版本的资源(名称、大小、URL)。 |
download_release_asset | 通过并行范围请求,从多个镜像下载一个资源(按 name)或多个资源(按 glob pattern);如果有 sha256,则进行校验。 |
安装 / 运行
# run instantly (no install)
uvx gh-release-mcp
# or via pip
pip install gh-release-mcp
gh-release-mcp
它通过 stdio 使用 MCP 通信。
配置客户端
opencode(opencode.json):
{
"mcp": {
"gh-release": {
"type": "local",
"command": ["uvx", "gh-release-mcp"]
}
}
}
Claude Desktop / Cursor(mcpServers):
{
"mcpServers": {
"gh-release": { "command": "uvx", "args": ["gh-release-mcp"] }
}
}
工具详解
download_release_asset 参数:
| 参数 | 含义 |
|---|---|
owner、repo | 例如:NationalSecurityAgency、ghidra |
tag | 发布标签;可省略或设为 latest |
name | 精确的资源名称(可选) |
pattern | glob,例如:*PUBLIC*.zip(可选) |
dest | 目标目录(默认:当前工作目录) |
mirrors | 镜像前缀(必须支持 Range);默认使用 ghproxy.net + ghfast.top |
connections | 每个文件的分段数(默认 8) |
环境变量:GITHUB_TOKEN(可选,可提高 API 限额/访问私有仓库)。
提示词示例
- “使用 gh-release,列出
BurntSushi/ripgrep最新版本的资源。” - “将
NationalSecurityAgency/ghidra的Ghidra_12.1.4_build中匹配*PUBLIC*.zip的资源下载到./ghidra。”
相关项目
- CLI 工具(非 MCP):gh-download · PyPI
gh-download-embedai - 博客:https://embedai.com.cn
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。