Servidor MCP de proyectos de GitHub

Un servidor MCP (Protocolo de contexto de modelo) que permite a los agentes de IA crear y gestionar proyectos basados en Agile Sprint mediante proyectos de GitHub.

Características

• API de Proyectos de GitHub v2 : Soporte completo para la API de Proyectos GraphQL v2 de GitHub

• Problemas de GitHub : crear, leer y actualizar problemas de GitHub

• Repositorios de GitHub : obtener detalles del repositorio

• Seguridad de tipos : creado con TypeScript para máxima seguridad de tipos

Related MCP server: GitHub Enterprise MCP Server

Instalación

Instalación mediante herrería

Para instalar GitHub Projects MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install taylor-lindores-reeves/mcp-github-projects --client claude

Uso

Instalación manual

1. Clonar este repositorio:

   git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git
   cd mcp-github-projects

2. Instalar dependencias:

   bun install

3. Crea un archivo .env con tu token de GitHub:

   GITHUB_TOKEN=your_github_personal_access_token
   GITHUB_OWNER=your_github_username

4. Construir el servidor:

   bun run build

5. Configure su cliente MCP con las siguientes configuraciones:

{
  "mcpServers": {
    "GitHubProjects": {
      "command": "bun",
      "args": [
        "/path/to/your/directory/mcp-github-projects-main/build/index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "GITHUB_OWNER": "your_github_username_or_org"
      }
    }
  }
}

Variables de entorno

• GITHUB_TOKEN : Token de acceso personal de GitHub con los permisos adecuados

• GITHUB_OWNER : nombre de usuario de GitHub o nombre de la organización

Permisos de token de GitHub

Este servidor MCP requiere un token de acceso personal de GitHub (clásico) con los siguientes permisos:

• project - Control total de proyectos

• read:project - Acceso de lectura de proyectos

• repo - Control total de repositorios privados

• repo:status - Acceder al estado de confirmación

• repo_deployment - Acceder al estado de la implementación

• public_repo - Acceder a repositorios públicos

• repo:invite - Acceder a las invitaciones del repositorio

• security_events - Leer y escribir eventos de seguridad

Desarrollo

Comandos

• Construir: bun run build

• Generar tipos GraphQL: bun run graphql-codegen

Estructura del proyecto

Este proyecto es un servidor MCP para la API GraphQL de GitHub, centrado en las operaciones del Proyecto V2. El código base proporciona acceso tipificado a la funcionalidad de los proyectos de GitHub mediante GraphQL.

Operaciones disponibles

Proyectos

• Crear, leer, actualizar y eliminar proyectos de GitHub

• Administrar campos, elementos y actualizaciones de estado del proyecto

• Convertir borradores de problemas en problemas reales

• Archivar y desarchivar elementos del proyecto

Asuntos

• Obtener detalles del problema

• Agregar problemas a los proyectos

Repositorios

• Obtener información del repositorio