Servidor MCP de proyectos de GitHub

insignia de herrería

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 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

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.