Servidor MCP del Administrador de proyectos de GitHub

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona la funcionalidad de Proyectos de GitHub mediante herramientas y recursos estandarizados. Este servidor permite a los clientes de LLM gestionar Proyectos de GitHub mediante programación a través de la interfaz MCP.

Descripción general

Este servidor implementa el Protocolo de Contexto de Modelo para exponer la funcionalidad de Proyectos de GitHub a los clientes LLM. Proporciona herramientas para gestionar proyectos, hitos, sprints y métricas mediante la API GraphQL de GitHub, manteniendo el estado y gestionando errores según las especificaciones de MCP.

Características principales

• Gestión de proyectos

  • Crear y administrar proyectos de GitHub (v2)

  • Manejar configuraciones y ajustes del proyecto

  • Gestionar la visibilidad y el acceso al proyecto

• Recursos del proyecto

  • Gestión de problemas e hitos

  • Planificación y seguimiento de sprints

  • Campos y vistas personalizados

  • Control de versiones y bloqueo de recursos

• Implementación de MCP

  • Cumplimiento total de las especificaciones MCP

  • Definiciones de herramientas estandarizadas con validación Zod

  • Gestión del estado de los recursos

  • Manejo de respuesta progresiva

  • Manejo integral de errores

• Integración de GitHub

  • Integración de API GraphQL con soporte de paginación

  • Manejo inteligente del límite de velocidad

  • Concurrencia optimista

  • Compatibilidad con webhooks (planificado)

Instalación

Configuración

Variables de entorno requeridas:

El token de GitHub requiere estos permisos:

• repo (Acceso completo al repositorio)

• project (Acceso al proyecto)

• write:org (Acceso de la organización)

Uso

Consulte la Guía del usuario para obtener instrucciones de uso detalladas.

Arquitectura

El servidor sigue los principios de Arquitectura Limpia con capas diferenciadas:

• Capa de dominio : entidades centrales, interfaces de repositorio y esquemas Zod

• Capa de infraestructura : Integración e implementación de la API de GitHub

• Capa de servicio : coordinación de la lógica empresarial

• Capa MCP : definiciones de herramientas y manejo de solicitudes

Consulte ARCHITECTURE.md para obtener documentación detallada de la arquitectura.

Estado actual

Características principales

Implementación de MCP

Mejoras recientes

• Sistema de recursos mejorado :

  • Se agregó la validación del esquema Zod para todos los tipos de recursos

  • Se implementó el seguimiento de las relaciones entre recursos

  • Se creó una ResourceFactory centralizada para un acceso consistente a los recursos

• Integración mejorada de la API de GitHub :

  • Se agregó limitación de velocidad inteligente con limitación automática

  • Se implementó el soporte de paginación para las API REST y GraphQL

  • Manejo mejorado de errores con tipos de errores específicos

• Sistema de herramientas avanzado :

  • Se creó un registro de definición de herramientas con validación de Zod

  • Se implementó un formato de respuesta de herramienta estandarizado

  • Se agregó documentación basada en ejemplos para todas las herramientas.

• Formato de respuesta enriquecido :

  • Se agregó soporte para múltiples tipos de contenido (JSON, Markdown, HTML, Texto)

  • Se implementaron actualizaciones de progreso para operaciones de larga duración.

  • Se agregó soporte de paginación para conjuntos de resultados grandes

Brechas funcionales identificadas

A pesar de las recientes mejoras, aún existen las siguientes brechas funcionales y se priorizan para el desarrollo futuro:

1. Estrategia de almacenamiento en caché persistente :

   • Si bien ResourceCache proporciona almacenamiento en caché en memoria, carece de persistencia tras reinicios del servidor.

   • Sin almacenamiento en caché distribuido para implementaciones de múltiples instancias

   • Faltan políticas de desalojo de caché para la gestión de memoria

2. Procesamiento de eventos en tiempo real :

   • Sin integración de webhook para actualizaciones en tiempo real desde GitHub

   • Falta un sistema de suscripción basado en eventos para los clientes

   • Falta de compatibilidad con eventos enviados por el servidor (SSE) para actualizaciones en tiempo real

3. Características avanzadas de Proyectos de GitHub v2 :

   • Soporte limitado para tipos de campos personalizados y validación

   • Integración incompleta con los tipos de campos de Proyectos v2 más nuevos de GitHub

   • Falta la gestión de reglas de automatización

4. Optimización del rendimiento :

   • No se realizan agrupaciones de consultas para recursos relacionados

   • Falta la actualización en segundo plano de los recursos a los que se accede con frecuencia

   • Búsqueda previa incompleta de recursos relacionados

5. Visualización y generación de informes de datos :

   • No hay generadores de visualización integrados para métricas

   • Faltan capacidades de generación de informes

   • Análisis de datos de series temporales limitadas

Consulte docs/mcp/gaps-analysis.md para conocer el estado de implementación detallado.

Documentación

• Guía del usuario : instrucciones de uso detalladas

• Referencia de API : documentación completa de herramientas

• Tutoriales - Guías paso a paso

• Ejemplos : ejemplos de código para tareas comunes

• Arquitectura - Arquitectura y diseño de sistemas

• Contribución - Pautas de desarrollo

• Documentación de MCP : detalles específicos de MCP

Documentación interactiva

Para una exploración interactiva de la API, abra el Explorador de API en su navegador.

Desarrollo

Pruebas

Calidad del código

Contribuyendo

Agradecemos las contribuciones al servidor MCP de GitHub Project Manager. Consulta nuestra Guía de Contribución para obtener más información sobre:

• Flujo de trabajo de desarrollo

• Estándares de código

• Pautas de prueba

• Directrices de documentación

Licencia

Instituto Tecnológico de Massachusetts (MIT)