Skip to main content
Glama
mcp-github-server

mcp-github-server

by pblarismendi

🐙 Servidor MCP para GitHub

Un servidor completo de Model Context Protocol (MCP) para interactuar con GitHub. Permite gestionar repositorios, issues, pull requests, branches, commits, releases, webhooks y mucho más desde Cursor o Claude Desktop.

✨ Características Principales

  • ✅ Gestión completa de repositorios (listar, buscar, obtener detalles)

  • ✅ Pull Requests (crear, mergear, cerrar, actualizar, reviews)

  • ✅ Issues (crear, actualizar, cerrar, comentarios)

  • ✅ Búsqueda avanzada (código, issues, usuarios, commits)

  • ✅ Gestión de commits (obtener detalles, listar, comparar)

  • ✅ Releases y Tags (crear, listar, obtener detalles)

  • ✅ Webhooks (crear, actualizar, eliminar, ping)

  • ✅ Protección de ramas (configurar reglas de protección)

  • ✅ Multiplataforma (macOS, Linux, Windows)

Related MCP server: GitHub MCP Server

🚀 Instalación Rápida

Requisitos

  • Node.js 18+ instalado

  • npm o pnpm

  • Personal Access Token de GitHub con permisos repo

Instalación desde npm

npm install -g mcp-github-server
# o con pnpm:
pnpm add -g mcp-github-server

Instalación desde código fuente

git clone https://github.com/pblarismendi/mcp-github-server.git
cd mcp-github-server
npm install
npm run build

🔑 Configuración

1. Obtener un Personal Access Token de GitHub

  1. Ve a GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)

  2. Haz clic en "Generate new token (classic)"

  3. Dale un nombre descriptivo (ej: "MCP Server")

  4. Selecciona los scopes:

    • ✅ repo (Full control of private repositories)

    • ✅ read:org (opcional, para organizaciones)

  5. Haz clic en "Generate token"

  6. Copia el token inmediatamente (solo se muestra una vez)

2. Configurar en Cursor/Claude Desktop

Cursor

Ubicación: ~/.cursor/mcp.json o .cursor/mcp.json en tu workspace

Configuración - Método 1: Con npx (Recomendado - Más Simple)

Este método no requiere encontrar rutas absolutas ni instalar globalmente:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mcp-github-server"],
      "env": {
        "GITHUB_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Configuración - Método 2: Con ruta absoluta

Si prefieres usar una instalación global, usa la ruta absoluta:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["RUTA_ABSOLUTA/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Ejemplos de rutas:

  • macOS: "/Users/tu_usuario/.npm-global/lib/node_modules/mcp-github-server/dist/index.js"

  • Linux: "/usr/local/lib/node_modules/mcp-github-server/dist/index.js"

  • Windows: "C:\\Users\\tu_usuario\\AppData\\Roaming\\npm\\node_modules\\mcp-github-server\\dist\\index.js"

Claude Desktop

Ubicación:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuración: (igual que Cursor)

3. Encontrar la ruta de instalación (Solo si usas Método 2)

Si instalaste globalmente con npm/pnpm y necesitas la ruta absoluta, encuentra la ruta con:

npm list -g mcp-github-server
# o
pnpm list -g mcp-github-server

O busca el ejecutable:

# macOS/Linux:
which mcp-github
which mcp-github-server

# Windows (PowerShell/CMD):
where mcp-github
where mcp-github-server

Nota: Si where mcp-github-server no encuentra nada en Windows, usa el Método 1 con npx que no requiere encontrar rutas.

💻 Uso Básico

Una vez configurado, el servidor MCP estará disponible en Cursor o Claude Desktop. Puedes usar comandos como:

  • "Lista mis repositorios"

  • "Muéstrame los PRs abiertos del repositorio X"

  • "Crea un issue en el repositorio Y"

  • "Busca código que contenga 'function calculate'"

🛠️ Herramientas Disponibles

Repositorios

  • list_repositories - Lista repositorios con filtros

  • get_repository - Obtiene detalles de un repositorio

  • search_repositories - Busca repositorios en GitHub

Pull Requests

  • list_pull_requests - Lista PRs

  • create_pull_request - Crea un PR

  • get_pull_request - Obtiene detalles de un PR

  • merge_pull_request - Mergea un PR (merge, squash, rebase)

  • close_pull_request - Cierra un PR

  • update_pull_request - Actualiza un PR

  • add_pull_request_review - Agrega una review

  • list_pull_request_reviews - Lista reviews de un PR

Issues

  • list_issues - Lista issues

  • create_issue - Crea un issue

  • update_issue - Actualiza un issue

  • close_issue - Cierra un issue

  • add_issue_comment - Agrega un comentario

  • list_issue_comments - Lista comentarios

Búsqueda

  • search_code - Busca código en repositorios

  • search_issues - Busca issues y PRs

  • search_users - Busca usuarios

  • search_commits - Busca commits

Commits

  • get_commit - Obtiene detalles de un commit

  • list_commits - Lista commits con filtros

  • compare_commits - Compara commits o branches

Releases y Tags

  • list_releases - Lista releases

  • get_release - Obtiene detalles de un release

  • create_release - Crea un release

  • list_tags - Lista tags

  • create_tag - Crea un tag

Webhooks

  • list_webhooks - Lista webhooks

  • get_webhook - Obtiene detalles de un webhook

  • create_webhook - Crea un webhook

  • update_webhook - Actualiza un webhook

  • delete_webhook - Elimina un webhook

  • ping_webhook - Hace ping a un webhook

Branches

  • list_branches - Lista branches

  • protect_branch - Protege una rama

Otros

  • get_user_info - Obtiene información del usuario

  • get_file_content - Lee archivos o directorios

🐛 Solución de Problemas

Error: "GITHUB_TOKEN no está configurado"

  • Verifica que el token esté en la configuración de Cursor/Claude Desktop

  • Asegúrate de que no haya espacios antes o después del token

Error: "Bad credentials"

  • Tu token puede haber expirado

  • Genera un nuevo token en GitHub y actualiza la configuración

El servidor no se conecta

  • Verifica que la ruta al archivo dist/index.js sea correcta y absoluta (si usas Método 2)

  • Asegúrate de haber instalado el paquete correctamente

  • Revisa los logs de Cursor/Claude Desktop para ver errores específicos

  • Solución rápida: Usa el Método 1 con npx que no requiere rutas absolutas

Problemas Específicos de Windows

El ejecutable no se encuentra después de instalar globalmente

Problema: Después de ejecutar npm install -g mcp-github-server, el comando where mcp-github-server no encuentra nada.

Solución 1 (Recomendada): Usa npx en lugar de buscar el ejecutable:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mcp-github-server"],
      "env": {
        "GITHUB_TOKEN": "tu_token_aqui"
      }
    }
  }
}

Solución 2: Encuentra la ruta manualmente:

  1. Ejecuta en PowerShell o CMD:

    npm list -g mcp-github-server
  2. Busca la ruta en la salida (normalmente algo como):

    C:\Users\tu_usuario\AppData\Roaming\npm\node_modules\mcp-github-server
  3. Usa la ruta completa en la configuración:

    {
      "mcpServers": {
        "github": {
          "command": "node",
          "args": ["C:\\Users\\tu_usuario\\AppData\\Roaming\\npm\\node_modules\\mcp-github-server\\dist\\index.js"],
          "env": {
            "GITHUB_TOKEN": "tu_token_aqui"
          }
        }
      }
    }

El archivo .cmd no se creó después de la instalación global

Problema: Windows necesita archivos .cmd o .exe pero npm no los creó automáticamente.

Solución: Esto es normal y no es un problema. Puedes usar cualquiera de estos métodos:

  1. Usar npx (más simple):

    {
      "command": "npx",
      "args": ["-y", "mcp-github-server"]
    }
  2. Usar node directamente con la ruta:

    {
      "command": "node",
      "args": ["RUTA_COMPLETA/dist/index.js"]
    }

Problemas con rutas en Windows

  • Usa barras normales / o dobles backslashes \\

  • Ejemplo: "C:\\Users\\Usuario\\...\\dist\\index.js" o "C:/Users/Usuario/.../dist/index.js"

  • Recomendación: Usa npx para evitar problemas con rutas

📚 Documentación Completa

Para más información sobre desarrollo, contribución, testing y características avanzadas, consulta:

💖 Sponsor este Proyecto

Si este proyecto te resulta útil, considera patrocinarme:

GitHub Sponsors

Tu apoyo ayuda a mantener y mejorar este proyecto. ¡Gracias! 🙏

👨‍💻 Desarrollador

Desarrollado con ❤️ por Pablo Arismendi

📝 Licencia

MIT

📞 Soporte

Si encuentras algún problema o tienes preguntas:

Available Tools

39 tools
add_issue_commentB

Agrega un comentario a un issue

Inputs: body (required), repo (required), owner (required), issue_number (required).

add_pull_request_reviewA

Agrega una review (aprobación, cambios solicitados, comentario) a un pull request

Inputs: repo (required), event (required), owner (required), pull_number (required), +1 more.

close_issueC

Cierra un issue

Inputs: repo (required), owner (required), issue_number (required).

close_pull_requestA

Cierra un pull request sin mergearlo

Inputs: repo (required), owner (required), pull_number (required).

compare_commitsB

Compara dos commits o branches y muestra las diferencias

Inputs: base (required), head (required), repo (required), owner (required).

create_issueB

Crea un nuevo issue en un repositorio

Inputs: repo (required), owner (required), title (required), body, +2 more.

create_pull_requestB

Crea un nuevo pull request en un repositorio

Inputs: base (required), head (required), repo (required), owner (required), +3 more.

create_releaseB

Crea un nuevo release en un repositorio

Inputs: repo (required), owner (required), tag_name (required), body, +4 more.

create_tagB

Crea un tag en un repositorio (sin release)

Inputs: tag (required), repo (required), owner (required), message (required), +2 more.

create_webhookB

Crea un nuevo webhook en un repositorio

Inputs: url (required), repo (required), owner (required), active, +4 more.

delete_webhookB

Elimina un webhook de un repositorio

Inputs: repo (required), owner (required), hook_id (required).

get_commitB

Obtiene detalles de un commit específico

Inputs: ref (required), repo (required), owner (required).

get_file_contentB

Obtiene el contenido de un archivo específico de un repositorio

Inputs: path (required), repo (required), owner (required), ref.

get_pull_requestA

Obtiene información detallada de un pull request específico

Inputs: repo (required), owner (required), pull_number (required).

get_releaseB

Obtiene detalles de un release específico

Inputs: repo (required), owner (required), tag, release_id.

get_repositoryB

Obtiene información detallada de un repositorio específico

Inputs: repo (required), owner (required).

get_user_infoB

Obtiene información del usuario autenticado

Inputs: no named parameters.

get_webhookA

Obtiene detalles de un webhook específico

Inputs: repo (required), owner (required), hook_id (required).

list_branchesC

Lista las ramas de un repositorio

Inputs: repo (required), owner (required), page, per_page, +1 more.

list_commitsA

Lista commits de un repositorio o branch específico

Inputs: repo (required), owner (required), sha, page, +5 more.

list_issue_commentsC

Lista los comentarios de un issue

Inputs: repo (required), owner (required), issue_number (required), page, +1 more.

list_issuesB

Lista los issues de un repositorio. Puedes filtrar por estado, etiquetas, asignado, etc.

Inputs: repo (required), owner (required), page, state, +3 more.

list_pull_request_reviewsB

Lista todas las reviews de un pull request

Inputs: repo (required), owner (required), pull_number (required).

list_pull_requestsB

Lista los pull requests de un repositorio

Inputs: repo (required), owner (required), base, head, +3 more.

list_releasesC

Lista los releases de un repositorio

Inputs: repo (required), owner (required), page, per_page.

list_repositoriesA

Lista todos los repositorios (públicos y privados) de tu cuenta de GitHub. Puedes filtrar por visibilidad, tipo y ordenar los resultados.

Inputs: page, sort, type, per_page, +2 more.

list_tagsC

Lista los tags de un repositorio

Inputs: repo (required), owner (required), page, per_page.

list_webhooksB

Lista los webhooks de un repositorio

Inputs: repo (required), owner (required), page, per_page.

merge_pull_requestB

Mergea un pull request. Soporta merge, squash y rebase

Inputs: repo (required), owner (required), pull_number (required), commit_title, +2 more.

ping_webhookA

Envía un ping a un webhook para verificar que funciona

Inputs: repo (required), owner (required), hook_id (required).

protect_branchB

Protege una rama del repositorio. Requiere PRs para mergear y puede requerir aprobaciones.

Inputs: repo (required), owner (required), branch (required), require_pr, +6 more.

search_codeB

Busca código en repositorios de GitHub. Permite encontrar archivos, funciones, clases, etc.

Inputs: query (required), page, sort, order, +1 more.

search_commitsB

Busca commits en GitHub por mensaje, autor, fecha, etc.

Inputs: query (required), page, sort, order, +1 more.

search_issuesC

Búsqueda avanzada de issues y pull requests en GitHub

Inputs: query (required), page, sort, order, +1 more.

search_repositoriesB

Busca repositorios en GitHub usando la API de búsqueda

Inputs: query (required), page, sort, order, +1 more.

search_usersB

Busca usuarios en GitHub por nombre, email, ubicación, etc.

Inputs: query (required), page, sort, order, +1 more.

update_issueB

Actualiza un issue existente (título, cuerpo, estado, labels, asignados)

Inputs: repo (required), owner (required), issue_number (required), body, +4 more.

update_pull_requestC

Actualiza el título, descripción o estado de un pull request

Inputs: repo (required), owner (required), pull_number (required), base, +3 more.

update_webhookB

Actualiza un webhook existente

Inputs: repo (required), owner (required), hook_id (required), url, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 39 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with clear separation between search, get, list, create, update, delete, and close operations. Even similar operations like close_issue and update_issue are distinct in purpose and description.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case, with verbs like list, get, create, update, delete, close, merge, and search. The naming clearly communicates the action and target resource without mixing conventions.

    Tool Count2/5

    With 39 tools, the server is significantly larger than typical MCP servers. While many GitHub operations are covered, the count exceeds the practical threshold for agent navigation, making it feel bloated and hard to manage.

    Completeness3/5

    The tool set covers many GitHub features—repos, issues, PRs, webhooks, releases, tags—but lacks repository creation, file operations, and delete/update for several resources such as issues, releases, and tags, creating dead ends in common workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that enables Claude and other compatible LLMs to interact with the GitHub API, supporting features like creating issues, retrieving repository information, listing issues, and searching repositories.
      4
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI agents to directly manage GitHub repositories, including PRs, issues, and code search, using natural language.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A working MCP server that connects to the real GitHub API, enabling users to manage repositories, issues, pull requests, and more through natural language in Claude Desktop.
      -