mcpField
G
GitHub Release MCP

GitHub Release MCP

本地服务
github.com/zishuowang696版本控制02 周前更新

关于 GitHub Release MCP

GitHub Release MCP 是供 Agent 检索 GitHub Release 资源的 Python MCP 服务,支持经多个镜像并行分段下载,并在可用时校验资源的 SHA-256 摘要。

主要功能

  1. 01列出 Release 资源
  2. 02按名称或 glob 模式下载资源
  3. 03通过多个镜像并行分段下载
  4. 04在可用时校验 SHA-256
  5. 05仅使用 Python 标准库

适用场景

  1. 01查看 GitHub Release 中的资源
  2. 02在网络受限环境下载指定文件
  3. 03依据发布的摘要检查下载文件

MCP 相关

该服务通过 MCP stdio 通信,提供列出和下载 GitHub Release 资源的工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"zishuowang696-gh-release": {
"command": "uvx",
"args": [
"gh-release-mcp"
]
}
}
}
启动命令uvx gh-release-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypigh-release-mcp0.1.1

工具

2

收录的工具列表 · 更新于 2 周前

参数类型必填说明
tagstring否发布标签;省略或使用 'latest' 表示最新版本。
repostring是仓库名称,例如 ghidra
ownerstring是仓库所有者,例如 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精确的资源名称(可选)
patternglob,例如:*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。”

相关项目

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。