gh-release-mcp

gh-release-mcp

Um servidor MCP que permite a um agente listar e baixar assets de releases do GitHub — com download paralelo em faixas com múltiplos espelhos e verificação sha256. Zero binários externos (biblioteca padrão pura de Python: sem aria2, curl, gh, jq). Por embedai.com.cn.

Projetado para redes restritas: ele verifica quais espelhos suportam HTTP Range (206), divide um arquivo entre espelhos e baixa segmentos em paralelo, depois verifica sha256 a partir do próprio digest de assets do GitHub.

Ferramentas

Ferramenta	O que faz
list_release_assets	Lista os assets de um release (nome, tamanho, url).
download_release_asset	Baixa um asset (por name) ou vários (por glob pattern) com requisições paralelas em faixas entre espelhos; verifica sha256 quando disponível.

Instalação / execução

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

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

Ele fala MCP via stdio.

Configure seu cliente

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

Ferramentas em detalhe

Argumentos de download_release_asset:

arg	significado
owner, repo	ex.: NationalSecurityAgency, ghidra
tag	tag do release; omita ou use latest
name	nome exato do asset (opcional)
pattern	glob, ex.: *PUBLIC*.zip (opcional)
dest	diretório de destino (padrão: diretório atual)
mirrors	prefixos de espelhos (devem suportar Range); padrão ghproxy.net + ghfast.top
connections	segmentos por arquivo (padrão 8)

Variáveis de ambiente: GITHUB_TOKEN (opcional, aumenta limites da API / repositórios privados).

Exemplos de prompts

• "Usando gh-release, liste os assets de BurntSushi/ripgrep mais recente."
• "Baixe NationalSecurityAgency/ghidra Ghidra_12.1.4_build correspondente a *PUBLIC*.zip em ./ghidra."

Relacionados

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

Licença

MIT