Kanboard MCP

🚀 Kanboard MCP Server

Kanboard統合のためのモデルコンテキストプロトコル（MCP）サーバー

強力なGoベースのMCPサーバーで、AIアシスタント（Claude DesktopやCursorなど）とKanboardプロジェクト管理システムをシームレスに統合できます。自然言語コマンドを通じて、Kanboardのプロジェクト、タスク、ユーザー、ワークフローを直接管理できます。

⚠️ 重要提示

以下のような問題を避けるために、mcpproxyをプロキシソリューションとして使用することをおすすめします。

📋 目次

• ✨ 主な機能
• 🚀 クイックスタート
• ⚙️ 設定
• 🛠️ 利用可能なツール
• 📖 使用例
• 🔧 開発
• 📄 ライセンス

✨ 主な機能

• 🔗 シームレスなKanboard統合 - Kanboardと直接API通信
• 🤖 自然言語処理 - 平易な英語でプロジェクトを管理
• 📊 完全なプロジェクト管理 - プロジェクト、タスク、ユーザー、カラムなどを扱う
• 🔐 安全な認証 - APIキーとユーザー名/パスワード認証の両方をサポート
• ⚡ 高性能 - 最適なパフォーマンスを得るためにGoで構築
• 🎯 MCP標準 - すべてのMCPクライアントと互換性がある

🚀 クイックスタート

前提条件

• Go 1.21以上
• APIアクセスが有効なKanboardインスタンス
• MCP互換クライアント（Cursor、Claude Desktopなど）

インストール

1. リポジトリをクローンする：

   git clone https://github.com/bivex/kanboard-mcp.git
   cd kanboard-mcp
   

2. 実行可能ファイルをビルドする：

   Windowsの場合：

   build-release.bat
   

   Linux/macOSの場合：

   ./build-release.sh
   

   手動でビルドする：

   go build -ldflags="-s -w" -o kanboard-mcp .
   

⚙️ 設定

1. 環境変数

環境変数を使用してKanboardの資格情報を設定します：

export KANBOARD_API_ENDPOINT="https://your-kanboard-url/jsonrpc.php"
export KANBOARD_API_KEY="your-kanboard-api-key"
export KANBOARD_USERNAME="your-kanboard-username"
export KANBOARD_PASSWORD="your-kanboard-password"

2. MCPクライアントの設定

クライアント用のMCP設定ファイルを作成します：

場所：

• Windows： C:\Users\YOUR_USERNAME\AppData\Roaming\Cursor\.cursor\mcp_config.json
• Linux/macOS： ~/.cursor/mcp_config.json

設定：

{
  "mcpServers": {
    "kanboard-mcp-server": {
      "command": "/path/to/your/kanboard-mcp",
      "args": [],
      "env": {
        "KANBOARD_API_ENDPOINT": "https://your-kanboard-url/jsonrpc.php",
        "KANBOARD_API_KEY": "your-kanboard-api-key",
        "KANBOARD_USERNAME": "your-kanboard-username",
        "KANBOARD_PASSWORD": "your-kanboard-password"
      }
    }
  }
}

3. クライアントを再起動する

設定を保存した後、MCPクライアント（Cursor、Claude Desktopなど）を再起動して変更を有効にします。

🛠️ 利用可能なツール

📁 プロジェクト管理

📝 タスク管理

💬 コメント管理

🏗️ カラム管理

🏷️ カテゴリ管理

🏊 スイムレーン管理

📋 ボード管理

🧑‍💻 現在のユーザー管理

🔗 外部タスクリンク管理

🔗 内部タスクリンク管理

🔗 リンク管理

📂 プロジェクトファイル管理

📝 プロジェクトメタデータ管理

🔐 プロジェクト権限管理

📝 サブタスク管理

⏰ サブタスクの時間追跡

🏷️ タグ管理

📂 タスクファイル管理

📝 タスクメタデータ管理

⚙️ アプリケーション管理

🤖 自動アクション管理

👥 グループ管理

👥 グループメンバー管理

👥 ユーザー管理

🏃 ScrumSprintプラグインAPI

📖 使用例

プロジェクトワークフロー

# 新しいプロジェクトを作成する
"Create a new project called 'Mobile App Development'"

# プロジェクトにタスクを追加する
"Create task 'Design UI mockups' in project 'Mobile App Development'"
"Create task 'Set up development environment' in project 'Mobile App Development'"

# すべてのタスクを取得する
"Get tasks for 'Mobile App Development' project"

# カラム間でタスクを移動する
"Move task 1 to 'In Progress' column"
"Move task 2 to 'Done' column"

チーム管理

# 新しいチームメンバーを作成する
"Create user 'alice.smith' with password 'secure123' and email 'alice@company.com'"

# ユーザーをプロジェクトに割り当てる
"Assign user 'alice.smith' to project 'Mobile App Development' as project-member"

# チームメンバーにタスクを割り当てる
"Assign task 1 to user 'alice.smith'"

タスクの整理

# 整理のためにカテゴリを作成する
"Create category 'Critical Bugs'"
"Create category 'Feature Requests'"

# タスクにコメントを追加する
"Add comment 'This needs urgent attention' to task 5"

# 期限を設定する
"Set due date for task 3 to 2024-01-20"

🔧 開発

ソースからビルドする

# リポジトリをクローンする
git clone https://github.com/bivex/kanboard-mcp.git
cd kanboard-mcp

# 依存関係をインストールする
go mod download

# アプリケーションをビルドする
go build -o kanboard-mcp .

# テストを実行する
go test ./...

プロジェクト構造

kanboard-mcp/
├── main.go              # メインアプリケーションのエントリーポイント
├── go.mod               # Goモジュールの依存関係
├── go.sum               # 依存関係のチェックサム
├── build-release.bat    # Windowsのビルドスクリプト
├── build-release.sh     # Unixのビルドスクリプト
├── README.md            # このファイル
└── LICENSE.md           # ライセンス情報

コントリビュートする

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを開く

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSE.mdファイルを参照してください。