github-projects-mcp

Servidor MCP de Proyectos de GitHub V2

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para gestionar Proyectos de GitHub V2 a través de Claude y otros clientes MCP. Este servidor utiliza la API GraphQL de GitHub para interactuar con Proyectos de GitHub V2.

Características

• Enumerar y visualizar proyectos de GitHub V2 para usuarios y organizaciones
• Obtener campos y elementos del proyecto (problemas, solicitudes de incorporación de cambios, borradores de problemas)
• Crear problemas y agregarlos a proyectos
• Crear borradores de problemas directamente en los proyectos
• Actualizar los valores de los campos de los elementos del proyecto
• Eliminar elementos de los proyectos

Uso

Este servidor se puede usar con cualquier cliente MCP, como Claude Desktop. Añádalo a la configuración de su cliente MCP (p. ej., claude_desktop_config.json ).

Opción 1: Usar el paquete publicado

A continuación se muestra un ejemplo de configuración que utiliza uvx como ejecutor de comandos:

Asegúrate de reemplazar your_pat_here con tu token de acceso personal de GitHub real.

Opción 2: Desde el código fuente

Para ejecutar el proyecto directamente desde el código fuente, siga estos pasos:

Configuración

1. Clonar el repositorio:
   git clone git@github.com:Arclio/github-projects-mcp.git cd github-projects-mcp
2. Crear y activar un entorno virtual:
   uv venv source venv/bin/activate
3. Instalar dependencias:
   uv pip install -e .
4. Establezca su token de GitHub como una variable de entorno:Crea un token de acceso personal de GitHub y asígnale los permisos necesarios. Los permisos requeridos son: repo , project y read:org .Agregue el token a su archivo .env después de ejecutar este comando:
   cp .env.example .env
   Luego agregue lo siguiente a su archivo .env :
   export GITHUB_TOKEN=your_personal_access_token

Uso del código fuente

Al utilizar el código fuente, configure su cliente MCP de la siguiente manera:

Asegúrate de reemplazar /path/to/github-projects-mcp y your_pat_here con tu ruta de repositorio real y el token de acceso personal de GitHub.

Herramientas disponibles

• list_projects : enumera los proyectos de GitHub V2 para una organización o un usuario determinados
• get_project_fields : Obtener los campos disponibles en un proyecto de GitHub V2
• get_project_items : Obtener elementos en un proyecto de GitHub V2 (admite filtrado por estado o campos de selección única personalizados)
• create_issue : Crea un nuevo problema en GitHub
• add_issue_to_project : Agregar un problema existente de GitHub a un Proyecto V2
• update_project_item_field : Actualizar un valor de campo para un elemento del proyecto
• create_draft_issue : crea un borrador de problema directamente en un proyecto de GitHub V2
• delete_project_item : eliminar un elemento de un proyecto de GitHub V2

Consulte la documentación de la herramienta en el código del servidor para obtener información detallada sobre su uso.

Desarrollo

El proyecto se estructura de la siguiente manera:

• src/github_projects_mcp/ : Directorio principal del paquete
  • server.py : Implementación del servidor MCP con definiciones de herramientas
  • github_client.py : cliente GraphQL para interacciones con la API de GitHub

Para contribuir, asegúrese de:

1. Agregue un manejo de errores adecuado para todas las operaciones GraphQL
2. Agregar anotaciones de tipo para todas las funciones y parámetros
3. Actualice la documentación al agregar nuevas herramientas o funciones