mcpField
G
GitHub Release MCP

GitHub Release MCP

Local
github.com/zishuowang696Version Control0Updated 2w ago
Repository

About GitHub Release MCP

GitHub Release MCP is a Python MCP server for agents that need to inspect or retrieve GitHub release assets. It supports parallel ranged downloads through multiple mirrors and verifies asset SHA-256 digests when available.

Key features

  1. 01List release assets
  2. 02Download assets by name or glob pattern
  3. 03Parallel ranged downloads across mirrors
  4. 04Verify SHA-256 when available
  5. 05Pure Python standard library

Use cases

  1. 01Inspect assets in a GitHub release
  2. 02Download selected release files on restricted networks
  3. 03Check downloaded assets against published digests

MCP support

The server communicates over MCP stdio and exposes tools to list and download GitHub release assets.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "zishuowang696-gh-release": {
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}
Run commanduvx gh-release-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypigh-release-mcp0.1.1

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
tagstringNoRelease tag; omit or 'latest' for the latest release.
repostringYesRepo name, e.g. ghidra
ownerstringYesRepo owner, e.g. NationalSecurityAgency

Details

From the project README

gh-release-mcp

An MCP server that lets an agent list and download GitHub release assets — with multi-mirror parallel ranged download and sha256 verification. Zero external binaries (pure Python standard library: no aria2, curl, gh, jq). By embedai.com.cn.

Built for restricted networks: it probes which mirrors support HTTP Range (206), splits a file across mirrors and downloads segments in parallel, then verifies sha256 from GitHub's own asset digest.

Tools

ToolWhat it does
list_release_assetsList a release's assets (name, size, url).
download_release_assetDownload one asset (by name) or several (by glob pattern) with parallel ranged requests across mirrors; verifies sha256 when available.

Install / run

# run instantly (no install)
uvx gh-release-mcp

# or via pip
pip install gh-release-mcp
gh-release-mcp

It speaks MCP over stdio.

Configure your client

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"] }
  }
}

Tools in detail

download_release_asset arguments:

argmeaning
owner, repoe.g. NationalSecurityAgency, ghidra
tagrelease tag; omit or latest
nameexact asset name (optional)
patternglob, e.g. *PUBLIC*.zip (optional)
destdestination directory (default: cwd)
mirrorsmirror prefixes (must support Range); default ghproxy.net + ghfast.top
connectionssegments per file (default 8)

Env vars: GITHUB_TOKEN (optional, raises API limits / private repos).

Example prompts

  • "Using gh-release, list the assets of BurntSushi/ripgrep latest."
  • "Download NationalSecurityAgency/ghidra Ghidra_12.1.4_build matching *PUBLIC*.zip into ./ghidra."

Related

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.