mcp-github-server
Allows interaction with GitHub API, providing tools for managing repositories, pull requests, issues, commits, releases, tags, webhooks, branches, and performing searches on code, issues, users, and commits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-github-server list my open pull requests"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🐙 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-serverInstalació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
Ve a GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)
Haz clic en "Generate new token (classic)"
Dale un nombre descriptivo (ej: "MCP Server")
Selecciona los scopes:
✅
repo(Full control of private repositories)✅
read:org(opcional, para organizaciones)
Haz clic en "Generate token"
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.jsonLinux:
~/.config/Claude/claude_desktop_config.jsonWindows:
%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-serverO busca el ejecutable:
# macOS/Linux:
which mcp-github
which mcp-github-server
# Windows (PowerShell/CMD):
where mcp-github
where mcp-github-serverNota: 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 filtrosget_repository- Obtiene detalles de un repositoriosearch_repositories- Busca repositorios en GitHub
Pull Requests
list_pull_requests- Lista PRscreate_pull_request- Crea un PRget_pull_request- Obtiene detalles de un PRmerge_pull_request- Mergea un PR (merge, squash, rebase)close_pull_request- Cierra un PRupdate_pull_request- Actualiza un PRadd_pull_request_review- Agrega una reviewlist_pull_request_reviews- Lista reviews de un PR
Issues
list_issues- Lista issuescreate_issue- Crea un issueupdate_issue- Actualiza un issueclose_issue- Cierra un issueadd_issue_comment- Agrega un comentariolist_issue_comments- Lista comentarios
Búsqueda
search_code- Busca código en repositoriossearch_issues- Busca issues y PRssearch_users- Busca usuariossearch_commits- Busca commits
Commits
get_commit- Obtiene detalles de un commitlist_commits- Lista commits con filtroscompare_commits- Compara commits o branches
Releases y Tags
list_releases- Lista releasesget_release- Obtiene detalles de un releasecreate_release- Crea un releaselist_tags- Lista tagscreate_tag- Crea un tag
Webhooks
list_webhooks- Lista webhooksget_webhook- Obtiene detalles de un webhookcreate_webhook- Crea un webhookupdate_webhook- Actualiza un webhookdelete_webhook- Elimina un webhookping_webhook- Hace ping a un webhook
Branches
list_branches- Lista branchesprotect_branch- Protege una rama
Otros
get_user_info- Obtiene información del usuarioget_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.jssea 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
npxque 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:
Ejecuta en PowerShell o CMD:
npm list -g mcp-github-serverBusca la ruta en la salida (normalmente algo como):
C:\Users\tu_usuario\AppData\Roaming\npm\node_modules\mcp-github-serverUsa 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:
Usar npx (más simple):
{ "command": "npx", "args": ["-y", "mcp-github-server"] }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
npxpara evitar problemas con rutas
📚 Documentación Completa
Para más información sobre desarrollo, contribución, testing y características avanzadas, consulta:
README.DEV.md - Documentación completa para desarrolladores
GitHub Repository - Código fuente y issues
💖 Sponsor este Proyecto
Si este proyecto te resulta útil, considera patrocinarme:
Tu apoyo ayuda a mantener y mejorar este proyecto. ¡Gracias! 🙏
👨💻 Desarrollador
Desarrollado con ❤️ por Pablo Arismendi
GitHub: @pblarismendi
📝 Licencia
MIT
📞 Soporte
Si encuentras algún problema o tienes preguntas:
Abre un issue en GitHub
Consulta la documentación completa para desarrolladores
Available Tools
39 toolsadd_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
Scored across 39 tools
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.
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.
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.
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
An MCP server that gives your AI access to the source code and docs of all public github repos
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A MCP server built for developers enabling Git based project management with project and personal…
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.4ISC
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to directly manage GitHub repositories, including PRs, issues, and code search, using natural language.MIT
- FlicenseNot gradedqualityDmaintenanceA 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.-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables GitHub API operations such as managing repositories, issues, and pull requests through natural language.Apache 2.0