gh-release-mcp

gh-release-mcp

Un servidor MCP que permite a un agente listar y descargar archivos de lanzamiento de GitHub — con descarga paralela por rangos multi-mirror y verificación sha256. Cero binarios externos (solo biblioteca estándar de Python: sin aria2, curl, gh, jq). Por embedai.com.cn.

Diseñado para redes restringidas: detecta qué mirrors soportan HTTP Range (206), divide un archivo entre mirrors y descarga segmentos en paralelo, luego verifica sha256 desde el propio digest de los archivos de GitHub.

Herramientas

Herramienta	Qué hace
list_release_assets	Lista los archivos de un lanzamiento (nombre, tamaño, url).
download_release_asset	Descarga un archivo (por name) o varios (por glob pattern) con solicitudes paralelas por rangos entre mirrors; verifica sha256 cuando está disponible.

Instalación / ejecución

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

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

Habla MCP sobre stdio.

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

Herramientas en detalle

Argumentos de download_release_asset:

arg	significado
owner, repo	p. ej. NationalSecurityAgency, ghidra
tag	etiqueta de lanzamiento; omitir o latest
name	nombre exacto del archivo (opcional)
pattern	glob, p. ej. *PUBLIC*.zip (opcional)
dest	directorio de destino (por defecto: cwd)
mirrors	prefijos de mirror (deben soportar Range); por defecto ghproxy.net + ghfast.top
connections	segmentos por archivo (por defecto 8)

Variables de entorno: GITHUB_TOKEN (opcional, aumenta límites de API / repos privados).

Ejemplos de prompts

• "Usando gh-release, lista los archivos del último lanzamiento de BurntSushi/ripgrep."
• "Descarga NationalSecurityAgency/ghidra Ghidra_12.1.4_build que coincidan con *PUBLIC*.zip en ./ghidra."

Relacionado

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

Licencia

MIT