English Français العربية

GitHub Release MCP

Official registry Developer tools

List and download GitHub release assets with multi-mirror parallel ranged download.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package gh-release-mcp
Claude Code 
claude mcp add github-release-mcp -- uvx gh-release-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "github-release-mcp": {
            "command": "uvx",
            "args": [
                "gh-release-mcp==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. gh-release-mcp
  2. Tools
  3. Install / run
  4. Configure your client
  5. Tools in detail
  6. Example prompts
  7. Related
  8. License

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."

License

MIT

Frequently asked questions

What is GitHub Release MCP?

List and download GitHub release assets with multi-mirror parallel ranged download.

How do I install GitHub Release MCP?

It runs on your machine. In Claude Code: claude mcp add github-release-mcp -- uvx gh-release-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GitHub Release MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is GitHub Release MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GitHub Release MCP?

It is published by zishuowang696. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.