Skip to content
MCP server

GitHub Release MCP

List GitHub release assets and download them in parallel across mirrors with sha256 checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About GitHub Release MCP

GitHub Release MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Built for networks where GitHub downloads are slow or blocked, gh-release-mcp probes which mirrors support HTTP Range requests, splits a file into segments across them and fetches in parallel. Afterwards it checks sha256 against the digest GitHub publishes for the asset. It uses only the Python standard library, so aria2, curl, gh and jq are not needed.

Two tools exist. One lists a release's assets with name, size and URL. The other downloads one asset by exact name or several by glob such as PUBLIC.zip into a chosen directory. Defaults use ghproxy.net and ghfast.top mirrors with eight segments per file, and a GITHUB_TOKEN raises API limits or reaches private repos.

Run it with uvx gh-release-mcp over stdio. It is MIT licensed, and the same author maintains a separate gh-download CLI.

Install

Run in a terminal

claude mcp add gh-release-mcp -- uvx gh-release-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gh-release-mcp": {
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gh-release-mcp": {
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gh-release-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gh-release-mcp": {
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gh-release-mcp": {
      "command": "uvx",
      "args": [
        "gh-release-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

list_release_assets
Lists a release's assets with name, size and URL.
download_release_asset
Downloads one or more assets with parallel ranged requests.

What it does

Release asset listing
Shows names, sizes and URLs for a release.
Parallel ranged download
Splits downloads across several mirrors.
Glob matching
Download multiple assets with a pattern.
Checksum verification
Verifies sha256 from GitHub's digest.
No external binaries
Pure Python standard library.
Optional token
Raises limits and reaches private repos.

Good for

  • Fetch large release binaries on a restricted network
  • List the assets in the latest release of a project
  • Download only the zip that matches a pattern
  • Verify a download's checksum automatically

Pricing

Open source

Free, MIT licence

More servers for the same service

GitHub Release MCP FAQ

How do I run it?

With uvx gh-release-mcp, or install with pip install gh-release-mcp.

Which mirrors does it use?

ghproxy.net and ghfast.top by default, and you can set others that support Range.

Does it verify downloads?

Yes, sha256 when GitHub provides a digest.

What licence?

MIT.

Is GitHub Release MCP free?

Yes. GitHub Release MCP is open source, so you can use and self-host it for free.

How do I add GitHub Release MCP to Claude Code?

Run this command in your terminal: claude mcp add gh-release-mcp -- uvx gh-release-mcp

What are the best alternatives to GitHub Release MCP?

The closest alternatives to GitHub Release MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers