GitHub Kanban MCP Server

Gestiona issues de GitHub como un tablero Kanban usando la CLI de gh.

Documentación

🎯 GitHub Kanban MCP Server

📋 Resumen

GitHub Kanban MCP Server es un servidor de Model Context Protocol (MCP) que gestiona los issues de GitHub en formato de tablero kanban y optimiza la gestión de tareas de LLM.

🚀 Características

🔄 Gestión de issues de GitHub en formato kanban
🤖 Gestión automática de tareas mediante LLM
📊 Visualización del progreso del proyecto
🔗 Integración completa con GitHub
💬 Función de comentarios en tareas

📁 Estructura del proyecto

kanban-server/
├── src/                    # ソースコードディレクトリ
│   ├── handlers/          # リクエストハンドラー
│   │   ├── comment-handlers.ts  # コメント関連の処理
│   │   ├── issue-handlers.ts    # Issue関連の処理
│   │   ├── label-handlers.ts    # ラベル関連の処理
│   │   └── tool-handlers.ts     # ツールリクエストの処理
│   ├── schemas/           # 入力スキーマ定義
│   │   ├── comment-schemas.ts   # コメント関連のスキーマ
│   │   └── issue-schemas.ts     # Issue関連のスキーマ
│   ├── utils/             # ユーティリティ関数
│   │   ├── error-handler.ts     # エラー処理
│   │   └── exec.ts             # コマンド実行関連
│   ├── server.ts          # MCPサーバーの実装
│   └── types.ts           # 型定義
├── docs/                  # ドキュメント
│   └── v0.2.0/           # バージョン別ドキュメント
└── assets/               # アセットファイル

🛠️ Instalación

Requisitos previos

Node.js 18.x o superior
npm 9.x o superior
GitHub CLI (gh)

# パッケージのインストール
npm install @sunwood-ai-labs/github-kanban-mcp-server

# GitHub CLIの認証設定
gh auth login

⚙️ Configuración

Añade lo siguiente al archivo de configuración de MCP:

{
  "mcpServers": {
    "github-kanban": {
      "command": "github-kanban-mcp-server"
    }
  }
}

🔧 Herramientas disponibles

1. list_issues

Obtiene la lista de issues del tablero kanban.

Parámetros de entrada:

repo: Nombre del repositorio de GitHub (obligatorio)
state: Estado del issue ('open', 'closed', 'all')
labels: Matriz de etiquetas para filtrar

2. create_issue

Crea un nuevo issue.

Parámetros de entrada:

repo: Nombre del repositorio de GitHub (obligatorio)
title: Título del issue (obligatorio)
emoji: Emoji que se añade al inicio del título
body: Cuerpo del issue
labels: Matriz de etiquetas
assignees: Matriz de usuarios a asignar

3. update_issue

Actualiza un issue existente.

Parámetros de entrada:

repo: Nombre del repositorio de GitHub (obligatorio)
issue_number: Número del issue (obligatorio)
title: Nuevo título
emoji: Emoji que se añade al inicio del título
body: Nuevo cuerpo
state: Nuevo estado ('open', 'closed')
labels: Nueva matriz de etiquetas
assignees: Nueva matriz de asignaciones

4. add_comment

Añade un comentario a una tarea.

Parámetros de entrada:

repo: Nombre del repositorio de GitHub (obligatorio)
issue_number: ID de la tarea (Issue) (obligatorio)
body: Contenido del comentario (compatible con formato Markdown) (obligatorio)
state: Estado del issue que se modifica al comentar ('open', 'closed')

📝 Licencia

MIT License - Consulte el archivo LICENSE.

🤝 Contribuciones

Haga un fork de este repositorio
Cree una rama de funcionalidad (git checkout -b feature/amazing-feature)
Realice los commits de los cambios (git commit -m '✨ feat: 素晴らしい機能を追加')
Haga push a la rama (git push origin feature/amazing-feature)
Cree una solicitud de extracción (pull request)

📮 Comentarios

Si tiene problemas o sugerencias, cree un Issue.