# GitHub Release MCP

> GitHub Release MCP is an open-source MCP server for developer tools. List GitHub release assets and download them in parallel across mirrors with sha256 checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/zishuowang696/gh-release-mcp
- **MCP Registry name:** io.github.zishuowang696/gh-release-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add gh-release-mcp -- uvx gh-release-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/github-release-mcp
