GitHub Kanban MCP Server

📋 Visão Geral

O GitHub Kanban MCP Server é um servidor Model Context Protocol (MCP) para gerenciar issues do GitHub em formato de quadro kanban e otimizar o gerenciamento de tarefas de LLMs.

🚀 Recursos

• 🔄 Gerenciar issues do GitHub em formato kanban
• 🤖 Gerenciamento automático de tarefas por LLM
• 📊 Visualização do progresso do projeto
• 🔗 Integração completa com o GitHub
• 💬 Função de comentários em tarefas

📁 Estrutura do Projeto

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/               # アセットファイル

🛠️ Instalação

Pré-requisitos

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

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

# GitHub CLIの認証設定
gh auth login

⚙️ Configuração

Adicione o seguinte ao arquivo de configuração do MCP:

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

🔧 Ferramentas disponíveis

1. list_issues

Obtém a lista de issues do quadro kanban.

Parâmetros de entrada:

• repo: Nome do repositório GitHub (obrigatório)
• state: Estado da issue ('open', 'closed', 'all')
• labels: Matriz de rótulos para filtragem

2. create_issue

Cria uma nova issue.

Parâmetros de entrada:

• repo: Nome do repositório GitHub (obrigatório)
• title: Título da issue (obrigatório)
• emoji: Emoji a ser adicionado no início do título
• body: Corpo da issue
• labels: Matriz de rótulos
• assignees: Matriz de usuários para atribuição

3. update_issue

Atualiza uma issue existente.

Parâmetros de entrada:

• repo: Nome do repositório GitHub (obrigatório)
• issue_number: Número da issue (obrigatório)
• title: Novo título
• emoji: Emoji a ser adicionado no início do título
• body: Novo corpo
• state: Novo estado ('open', 'closed')
• labels: Nova matriz de rótulos
• assignees: Nova matriz de atribuições

4. add_comment

Adiciona um comentário à tarefa.

Parâmetros de entrada:

• repo: Nome do repositório GitHub (obrigatório)
• issue_number: ID da tarefa (Issue) (obrigatório)
• body: Conteúdo do comentário (com suporte a Markdown) (obrigatório)
• state: Estado da issue a ser alterado ao comentar ('open', 'closed')

📝 Licença

MIT License - Consulte o arquivo LICENSE.

🤝 Contribuição

1. Faça um fork deste repositório
2. Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das alterações (git commit -m '✨ feat: 素晴らしい機能を追加')
4. Faça push para o branch (git push origin feature/amazing-feature)
5. Crie um pull request

📮 Feedback

Se tiver problemas ou sugestões, crie uma Issue.