GitHub

Interactúa con la API de GitHub para gestionar repositorios, incidencias y solicitudes de extracción.

Documentación

Servidor MCP (Model Context Protocol) de GitHub

¡Hola! Este es un servidor MCP de GitHub diseñado para permitir que LLMs compatibles con MCP, como Claude, se comuniquen con mi servidor MCP e interactúen con la API de GitHub.

Requisitos

  • TypeScript (lenguaje de programación)
  • Octokit (para realizar solicitudes de API a GitHub)
  • Model Context Protocol SDK

Configuración del proyecto localmente

  1. Clona el repositorio
  2. Ejecuta npm install
  3. Añade el archivo .env mirando la muestra proporcionada en el archivo .env.example
  4. Para compilar los archivos TypeScript a Javascript, ejecuta npx tsc
  5. Para finalmente ejecutar el proyecto, ejecuta node build/index.js

Formas de probar

Puedes probar tu servidor MCP de 2 maneras:

  • MCP inspector
  • Claude Desktop

Prueba usando MCP inspector

  1. Simplemente ejecuta npx @modelcontextprotocol/inspector node build/index.js en la terminal
  2. Ve a http://localhost:5173
  3. Ahora puedes ver el MCP inspector y probar.

Prueba usando Claude Desktop

  1. Descarga e instala Claude Desktop desde aquí
  2. Ve a Archivo > Configuración... > Desarrollador > Editar configuración
  3. Debería abrir la ubicación del archivo claude_desktop_config.json.
  4. Abre ese archivo en tu editor de código y añade lo siguiente:
    {
     "mcpServers": {
       "gh": {
         "command": "node",
         "args": ["absolute\\path\\to\\your\\index.js\\file"],
         "env": {
           "GITHUB_TOKEN": "your-github-personal-access-token"
         }
       }
     }
    }
    
  5. Sal y vuelve a abrir Claude Desktop

Funcionalidades

El MCP soporta principalmente dos características:

  • Herramientas (4)
    • create-issue: crear un nuevo issue en un repositorio de GitHub
    • get-repo-info: obtener información sobre un repositorio específico de GitHub
    • list-issues: listar issues en un repositorio de GitHub
    • search-repos: buscar repositorios de GitHub
  • Prompts (5)
    • create-issue-description: generar una descripción para un issue de GitHub
    • create-pull-request-description: generar una descripción para un pull request de GitHub
    • search-repos-prompt: generar una consulta para buscar repositorios de GitHub
    • create-issue-prompt: generar parámetros para crear un issue de GitHub
    • enhance-github-response: formatear y mejorar los datos de respuesta sin procesar de la API de GitHub

Puedes escribir tus propios prompts o seleccionar un prompt adecuado del menú desplegable en la opción "Choose an integration" para MCP en Claude Desktop