Servidor MCP de Github

Un servidor de protocolo de contexto modelo para Github.

Proporciona integración con Github a través de MCP, lo que permite que los LLM interactúen con él.

Documentación de la API REST de Github

Instalación

Instalación manual

1. Crear u obtener un token de acceso para su cuenta de Github: Guía
2. Agregar configuración de servidor a Claude Desktop:
   • MacOS: ~/Biblioteca/Soporte de aplicaciones/Claude/claude_desktop_config.json
   • Windows: Consulta esta guía

Componentes

Herramientas

1. search_repositories : busca un repositorio en GitHub.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 30, máximo: 100): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
2. search_issues : busca problemas de un repositorio.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
     • order (cadena opcional, predeterminado: desc ): tipo de orden ( asc o desc ).
     • sort (cadena opcional, valor predeterminado: best match ): campo de ordenamiento (puede ser uno de los siguientes: comments , reactions , reactions-+1 , reactions--1 , reactions-smile , reactions-thinking_face , reactions-heart , reactions-tada , interactions , created o updated ).
3. search_commits : busca confirmaciones de un repositorio.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
     • order (cadena opcional, predeterminado: desc ): tipo de orden ( asc o desc ).
     • sort (cadena opcional, valor predeterminado: best match ): campo de ordenamiento (puede ser uno de los siguientes: committer-date o author-date ).
4. search_code : Busca código de un repositorio.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
5. search_users : busca usuarios de un repositorio.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
     • order (cadena opcional, predeterminado: desc ): tipo de orden ( asc o desc ).
     • sort (cadena opcional, valor predeterminado: best match ): campo de ordenamiento (puede ser uno de: followers , repositories o joined ).
6. search_topics : Buscar temas.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
7. search_labels : Busca etiquetas en un repositorio.
   • Entradas requeridas:
     • query (cadena): la consulta para buscar el repositorio.
     • page (número, predeterminado: 1): Número de página para paginación.
     • per_page (número, predeterminado: 30, máximo: 100): Número de resultados por página.
     • order (cadena opcional, predeterminado: desc ): tipo de orden ( asc o desc ).
     • sort (cadena opcional, valor predeterminado: best match ): campo de ordenamiento (puede ser uno de los siguientes: created o updated ).
8. list_repositories_issues : enumera los problemas de un repositorio.
   • Entradas requeridas:
     • owner (cadena): el propietario del repositorio.
     • repo (cadena): el nombre del repositorio.
     • page (número opcional, predeterminado: 1): Número de página para paginación.
     • per_page (número opcional, predeterminado: 30, máximo: 100): Número de resultados por página.
     • direction (cadena opcional, predeterminada: desc ): Dirección de clasificación ( asc o desc ).
     • sort (cadena opcional, predeterminado: created ): campo de ordenación (puede ser uno de: created , comments o updated ).
     • since (cadena opcional): Resultados actualizados por última vez después del tiempo indicado (formato ISO 8601: AAAA-MM-DDTHH:MM:SSZ).
     • labels (cadena opcional): nombres de etiquetas separados por comas. Ejemplo: bug,ui,@high.
     • milestone (cadena opcional): número de hito.
     • assignee (cadena opcional): Nombre del usuario cesionario ( * para todos).
     • creator (cadena opcional): el usuario que creó el problema. ( * para todos).
     • mentioned (cadena opcional): un usuario que se menciona en el problema.
9. get_issue : obtener un problema de un repositorio.
   • Entradas requeridas:
     • owner (cadena): el propietario del repositorio.
     • repo (cadena): el nombre del repositorio.
     • issue_number (número): El número de emisión.
10. list_repositories_pull_requests : enumera las solicitudes de extracción de un repositorio.

• Entradas requeridas:
  • owner (cadena): el propietario del repositorio.
  • repo (cadena): el nombre del repositorio.
  • page (número opcional, predeterminado: 1): Número de página para paginación.
  • per_page (número opcional, predeterminado: 30, máximo: 100): Número de resultados por página.
  • direction (cadena opcional, predeterminada: desc ): Dirección de clasificación ( asc o desc ).
  • sort (cadena opcional, valor predeterminado: created ): campo de ordenamiento (puede ser uno de los siguientes: created , popularity , long-running o updated ).
  • head (cadena opcional): filtra las extracciones por usuario principal u organización principal y nombre de rama en el formato usuario:nombre-de-referencia u organización:nombre-de-referencia (por ejemplo: github:new-script-format o octocat:test-branch).
  • base (cadena opcional): filtra las extracciones por nombre de rama base. (Por ejemplo: gh-pages).

11. get_pull_request : obtiene una solicitud de extracción de un repositorio.

• Entradas requeridas:
  • owner (cadena): el propietario del repositorio.
  • repo (cadena): el nombre del repositorio.
  • pull_request_number (número): el número de solicitud de extracción.

Ejemplos de uso

Algunos ejemplos de indicaciones que puedes usar para interactuar con Github:

1. "modelcontextprotocol" → ejecuta la herramienta search_repositories para encontrar repositorios donde se menciona modelcontextprotocol.
2. "¿Cuál es el problema 739 en el repositorio de servidores modelcontextprotocol?" → ejecute la herramienta get_issue para encontrar el problema 739 en el repositorio de servidores modelcontextprotocol.
3. "¿Cuál es el PR 717 en el repositorio de servidores modelcontextprotocol?" → ejecute la herramienta get_pull_request para encontrar el PR 717 en el repositorio de servidores modelcontextprotocol.

Desarrollo

1. Instalar dependencias:

2. Configurar el token de acceso de Github en .env :

3. Ejecutar localmente con reloj:

4. Construir el servidor:

5. Depuración local con inspector: