gh-board-mcp

Servidor MCP para gestionar GitHub Projects v2 como un tablero kanban personal. Crea actividades (elementos borrador), muévelas entre columnas, rastrea prioridades — sin vincular a issues reales.

Requisitos

• Node.js >= 18

• Un Token de Acceso Personal de GitHub con el ámbito project (granular: Projects lectura/escritura)

Related MCP server: GitHub Projects MCP Server

Uso

GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Configúralo en tu cliente MCP (por ejemplo, Claude Code):

claude mcp add gh-board-mcp -- env GITHUB_TOKEN=ghp_xxx npx gh-board-mcp

Herramientas

Estado y Prioridad

• create_project crea un nuevo tablero con Estado = Por Hacer / En Progreso / Hecho y Prioridad = Urgente / Alta / Media / Baja.

• Los tableros creados a partir de una plantilla de GitHub mantienen sus propias opciones de Estado/Prioridad — pasa valores que existan en el tablero. create_activity, move_activity y list_activities informan las opciones válidas cuando se proporciona un valor desconocido.

• Las columnas personalizadas no son compatibles a través de la API (configúralas en la interfaz de GitHub).

Notas

• Límite de lectura: list_activities y list_projects leen hasta 100 elementos/proyectos en una sola llamada; los tableros más grandes se truncan.

• Consistencia eventual: Las escrituras en GitHub Projects v2 pueden tardar un momento en aparecer en las lecturas — un list_activities inmediatamente después de create_activity puede omitir brevemente el nuevo elemento.

• Creación no atómica: create_activity valida las opciones de estado/prioridad antes de crear, por lo que una opción incorrecta no deja nada atrás; un error de red transitorio durante la creación puede dejar un borrador sin sus valores de campo.

Desarrollo

npm install
npm test
npm run build
npm run dev

Licencia

MIT