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

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:

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

• CLI tool (no MCP): gh-download · PyPI gh-download-embedai
• Blog: https://embedai.com.cn

License

MIT