GitHub Release MCP
List GitHub release assets and download them in parallel across mirrors with sha256 checks
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gh-release-mcp": {
"command": "uvx",
"args": [
"gh-release-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gh-release-mcp": {
"command": "uvx",
"args": [
"gh-release-mcp"
]
}
}
}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.


