GitHub MCP
by anthropics
Convierte tu agente IA en un colaborador de GitHub con superpoderes
code Node.js Principiante Auto-hospedable Verificado Destacado
⭐ 5.2k stars 📦 38k/week 📅 Actualizado: hace 1sem
Descripción
GitHub MCP conecta tu asistente IA con la plataforma donde realmente vive tu codigo. En lugar de copiar y pegar descripciones de issues o buscar archivos a mano, tu agente puede interactuar con repositorios, pull requests e issues directamente a traves del Model Context Protocol. El resultado es un flujo de trabajo donde gestionar bugs, revisar codigo y administrar ramas sucede de forma conversacional, sin salir de tu editor.
Lo que diferencia a este server es la amplitud de operaciones que soporta. Desde buscar en repositorios y leer contenido de archivos hasta crear ramas, hacer push de commits y abrir pull requests, todo el ciclo de colaboracion en GitHub queda accesible para tu agente IA. No es una integracion de solo lectura; tu agente puede tomar acciones reales en tu nombre, lo que lo hace especialmente potente para equipos que quieren automatizar tareas repetitivas de mantenimiento de repositorios.
Como utiliza un token de acceso personal con los permisos que tu configures, mantienes el control de lo que el agente puede hacer. Empieza con permisos de solo lectura para explorar y amplia el acceso a medida que confies en tus flujos de trabajo. El server es ligero, corre localmente via stdio y no necesita mas infraestructura que Node.js y un token.
✅ Ideal para
Desarrolladores y equipos que quieren que su agente IA interactue directamente con repositorios, issues y pull requests de GitHub
⏭️ No recomendado si
Si solo necesitas leer historial git local, un server git mas sencillo te bastara
💡 Casos de uso
- Clasificar y etiquetar issues de GitHub usando analisis de contenido con IA
- Automatizar la creacion de pull requests a partir de cambios generados por tu agente
- Buscar patrones de codigo o vulnerabilidades en multiples repositorios
- Revisar pull requests haciendo que tu agente lea diffs y publique comentarios inline
👍 Ventajas
- ✓ Cubre toda la superficie de la API de GitHub: repos, issues, PRs, codigo, ramas
- ✓ Proyecto oficial de Anthropic con mantenimiento activo y actualizaciones frecuentes
- ✓ Control detallado mediante los scopes del token de GitHub
- ✓ Funciona con todos los clientes MCP principales sin configuracion extra
👎 Desventajas
- ✗ Requiere un token de acceso personal de GitHub con los permisos adecuados
- ✗ Las operaciones de escritura (push, crear PR) necesitan gestion cuidadosa de scopes para evitar cambios no deseados
- ✗ Aun no soporta instancias on-premise de GitHub Enterprise Server
🔧 Herramientas expuestas (15 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| create_branch | branches | Crear una nueva rama a partir de una referencia |
| get_file_contents | code | Leer el contenido de un archivo de un repositorio |
| push_files | code | Hacer push de cambios de archivos a una rama del repositorio |
| search_code | code | Buscar codigo en repositorios de GitHub |
| list_commits | code | Listar commits de una rama del repositorio |
| list_issues | issues | Listar issues de un repositorio con filtros opcionales |
| create_issue | issues | Crear un nuevo issue en un repositorio |
| get_issue_comments | issues | Obtener todos los comentarios de un issue |
| create_issue_comment | issues | Anadir un comentario a un issue existente |
| get_pull_request | pull requests | Obtener detalles de un pull request especifico |
| list_pull_requests | pull requests | Listar pull requests de un repositorio |
| create_pull_request | pull requests | Crear un nuevo pull request |
| search_repositories | repositories | Buscar repositorios de GitHub por consulta |
| get_repository | repositories | Obtener informacion detallada de un repositorio especifico |
| fork_repository | repositories | Hacer fork de un repositorio a tu cuenta |
⚡ Instalación
Requisitos previos:
- • Node.js v18+
- • GitHub personal access token
- • API key requerida
claude mcp add github -- npx @anthropic-ai/github-mcp@latest💡 Consejos y trucos
Crea un token de GitHub dedicado con los scopes minimos que necesites. Para
exploracion de solo lectura, los scopes `repo:read` y `read:org` son suficientes.
Anade acceso completo a `repo` solo cuando quieras que tu agente haga push de
commits o abra PRs. Guarda el token en tu perfil de shell como GITHUB_TOKEN
para que todos los clientes MCP lo detecten automaticamente.
Info rápida
- Autor
- anthropics
- Licencia
- MIT
- Runtime
- Node.js 18+
- Transporte
- stdio
- Categoría
- code
- Dificultad
- Principiante
- Auto-hospedable
- ✅
- API key
- Requiere API key
- Docker
- —
- Versión
- 0.3.0
- Actualizado
- 14 feb 2026
Compatibilidad con clientes
- ✅ Claude Code
- ✅ Cursor
- ✅ VS Code Copilot
- ✅ Gemini CLI
- ✅ Windsurf
- ✅ Cline
- ✅ JetBrains AI
- ✅ Warp
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows