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.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

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

Related MCP Servers

mcp-github-project-manager
kunwarVivek
-
security
A
license
-
quality
Provides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.
Last updated -
414
31
TypeScript
MIT License
GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.
Last updated -
9
1
TypeScript
GitHub MCP Server
tuanle96
-
security
F
license
-
quality
Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
Last updated -
22,573
1
TypeScript
OSSInsight MCP Server
damonxue
A
security
F
license
A
quality
Provides GitHub data analysis for repositories, developers, and organizations, enabling insights into open source ecosystems through API calls and natural language queries.
Last updated -
5
2
JavaScript

View all related MCP servers

GitHub Projects MCP Server