github-mcp

Servidor MCP para la API REST de GitHub: 1.112 herramientas que cubren las 44 categorías de la API.

Generado automáticamente a partir de la especificación OpenAPI de GitHub mediante un generador de código que produce definiciones de herramientas tipadas con validación Zod.

Instalación

npm install github-rest-mcp

O desde GitHub Packages:

npm install @eyalm321/github-mcp

Configuración

Establece tu token de acceso personal de GitHub:

export GITHUB_TOKEN=ghp_your_token_here

Filtro de categorías

Por defecto, se registran las 1.112 herramientas. Para habilitar solo categorías específicas:

export GITHUB_MCP_CATEGORIES=repos,issues,pulls,actions

Claude Desktop

Añádelo a tu claude_desktop_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-rest-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "GITHUB_MCP_CATEGORIES": "repos,issues,pulls,actions,users,orgs,git,search"
      }
    }
  }
}

Categorías de la API

Nomenclatura de herramientas

Las herramientas siguen el patrón github_{categoría}_{acción}, derivado de los IDs de operación de GitHub:

• github_repos_get — Obtener un repositorio

• github_issues_create — Crear un issue

• github_pulls_list — Listar pull requests

• github_actions_list_workflow_runs — Listar ejecuciones de workflow

Desarrollo

# Install dependencies
npm install

# Regenerate tools from OpenAPI spec
npm run generate

# Build
npm run build

# Run tests
npm test

# Start the server
npm start

Regeneración de herramientas

Los archivos de herramientas en src/tools/ se generan automáticamente a partir de la especificación OpenAPI de GitHub. Para actualizar:

# Delete cached spec to force re-download
rm -f api-description.json

# Regenerate
npm run generate

Licencia

MIT