GitHub Release MCP

gh-release-mcp

エージェントが GitHub リリースアセットを一覧表示してダウンロードできる MCP サーバーです。複数ミラーを使った並列レンジダウンロードと sha256 検証に対応しています。外部バイナリは一切不要です（Python 標準ライブラリのみを使用し、aria2、curl、gh、jq は不要です）。embedai.com.cn によって提供されています。

ネットワークが制限された環境向けに構築されています。HTTP Range（206）に対応しているミラーを検出し、ファイルをミラー間で分割してセグメントを並列ダウンロードした後、GitHub 独自のアセット digest を使って sha256 を検証します。

ツール

ツール	機能
list_release_assets	リリースのアセット（名前、サイズ、URL）を一覧表示します。
download_release_asset	アセットを1つ（name で指定）または複数（glob pattern で指定）ダウンロードします。ミラーをまたいだ並列レンジリクエストに対応し、利用可能な場合は sha256 を検証します。

インストール／実行

# run instantly (no install)
uvx gh-release-mcp

# or via pip
pip install gh-release-mcp
gh-release-mcp

MCP over stdio で通信します。

クライアントの設定

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"] }
  }
}

ツールの詳細

download_release_asset の引数：

引数	意味
owner、repo	例：NationalSecurityAgency、ghidra
tag	リリースタグ。省略するか、latest を指定します
name	正確なアセット名（任意）
pattern	glob。例：*PUBLIC*.zip（任意）
dest	保存先ディレクトリ（デフォルト：cwd）
mirrors	ミラープレフィックス（Range に対応している必要があります）。デフォルトは ghproxy.net と ghfast.top です
connections	ファイルごとのセグメント数（デフォルト：8）

環境変数：GITHUB_TOKEN（任意。API の制限が緩和され、プライベートリポジトリにアクセスできます）。

プロンプトの例

• 「gh-release を使って、BurntSushi/ripgrep の最新リリースのアセットを一覧表示してください。」
• 「NationalSecurityAgency/ghidra の Ghidra_12.1.4_build で *PUBLIC*.zip に一致するものを ./ghidra にダウンロードしてください。」

関連情報

• CLI ツール（MCP なし）：gh-download · PyPI gh-download-embedai
• ブログ：https://embedai.com.cn

ライセンス

MIT