remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides integration with GitHub's Projects v2 API for Agile project management, allowing for managing GitHub Projects, Issues, and Repositories through a Model Context Protocol server.
Utilizes GraphQL for interacting with GitHub's Projects v2 API, supporting queries and mutations for projects, fields, items and other GitHub resources.

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

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

Clonar este repositorio:
git clone https://github.com/taylor-lindores-reeves/mcp-github-projects.git cd mcp-github-projects
Instalar dependencias:
bun install
Crea un archivo .env con tu token de GitHub:
GITHUB_TOKEN=your_github_personal_access_token GITHUB_OWNER=your_github_username
Construir el servidor:
bun run build
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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Permite a los usuarios interactuar con la API de Proyectos v2 de GitHub a través del lenguaje natural para la gestión de proyectos ágiles, respaldando los detalles del repositorio, el seguimiento de problemas y las operaciones de gestión del tablero de proyectos.

Related Resources

Reddit Discussion about this server