TaskBoardAI

TaskBoardAI

AI エージェント向けに設計された、軽量なファイルベースのカンバンボードです。
HIL コラボレーション用のウェブインターフェースを備えています。

AIX の機能：

• JSON ボードファイルにより、プロジェクトのコンテキスト全体を保持できます
• ボードの作成／削除／更新／読み取りに対応する MCP サーバー

HIL の機能：

• カードや列をドラッグ＆ドロップで並べ替え
• カードや列の追加／削除
• 利用可能なボードをドロップダウンで選択

注記
TaskBoardAI には独自の LLM 連携機能はありません。
ボードを更新する際は、プロジェクトのコンテキストを使用してください。

• 「外部ボードの場所を使用する」を参照
• 「MCP を使用する」を参照

機能

• Markdown サポート：完全な Markdown 構文でカードの内容を豊かに表現できます
• サブタスク：カード内で進捗を追跡し、完了をマークできます
• タグと依存関係：関連するカードを整理し、相互にリンクできます
• ドラッグ＆ドロップ：カード管理のための直感的なインターフェース
• 次のステップ：ボードレベルで今後の優先事項を追跡できます
• Webhook：Webhook 経由で他のサービスと連携できます
• AI 連携：MCP を使用して Claude for Desktop と接続できます

インストール

オプション 1：npm からインストール（推奨）

どこからでもコマンドラインで使えるよう、グローバルにインストールします：

npm install -g taskboardai

または、プロジェクトにローカルインストールします：

npm install taskboardai

オプション 2：リポジトリをクローン（開発用）

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

git clone https://github.com/TuckerTucker/TaskBoardAI.git
cd TaskBoardAI

2. 依存関係をインストールします：

npm install

使用方法

npm でインストールしたバージョンを使用する

npm でグローバルにインストールすると、次のコマンドを使用できます：

1. 利用可能なボードを一覧表示します：

taskboard --list

2. 新しいボードを作成します：

taskboard --new my-project

3. 既存のボードを開きます：

taskboard my-project

4. MCP サーバーを起動します：

taskboard-mcp

5. ボードサーバーと MCP サーバーの両方を起動します：

taskboard-all

リポジトリ版を使用する

リポジトリをクローンした場合は、付属のスクリプトを使用します：

1. 利用可能なボードを一覧表示します：

./_start_kanban --list

2. 新しいボードを作成します：

./_start_kanban --new my-project

3. 既存のボードを開きます：

./_start_kanban my-project

4. http://localhost:3001（デフォルトのポート）でボードにアクセスします

外部ボードの場所を使用する

*MCP 経由ではまだサポートされていません

1. プロジェクトのリポジトリに新しいボードディレクトリを作成します

2. サンプルボードをコピーします：

   npm からインストールした場合：

   # First, create an example board in your home directory
   taskboard --new example
   
   # Then copy it to your desired location
   cp ~/.taskboardai/boards/example.json /your/board/location/board_name.json
   

   リポジトリを使用する場合：

   cp /path/to/TaskBoardAI/boards/_kanban_example.json /your/board/location/board_name.json
   

3. 外部ボードの場所を指定してサーバーを起動します：

   npm からインストールした場合：

   taskboard --external /your/board/location/board_name.json
   

   リポジトリを使用する場合：

   ./_start_kanban --external /your/board/location/board_name.json
   

ボードの構造

カンバンボードは、次の構造を持つ JSON ファイルで定義されます： これにより、エージェントはプロジェクトのコンテキスト全体を把握できます

{
  "projectName": "Project Name",
  "id": "unique-board-id",
  "columns": [
    {
      "id": "column-id",
      "name": "Column Name"
    }
  ],
  "cards": [
    {
      "id": "card-id",
      "title": "Card Title",
      "content": "Markdown supported content",
      "columnId": "column-id",
      "position": 0,
      "collapsed": false,
      "subtasks": [
        "✓ Completed task",
        "Pending task"
      ],
      "tags": ["feature", "frontend"],
      "dependencies": ["other-card-id"],
      "created_at": "2025-01-18T10:00:00.000Z",
      "updated_at": "2025-01-19T12:30:00.000Z",
      "completed_at": "2025-01-19T18:12:35.604Z"
    }
  ],
  "next-steps": [
    "Next priority task",
    "Future focus area"
  ],
  "last_updated": "2025-01-19T19:20:14.802Z"
}

注：ボードの構造はカードファーストのアーキテクチャに更新されており、カードは列の中にネストされず、トップレベルの配列に格納されます。

AI 連携用 MCP サーバー

Model Context Protocol（MCP）とは？
TaskBoardAI には MCP（Model Context Protocol）サーバーが含まれており、MCP に対応する任意のツール（Claude Code、Cursor、Windsurf など）を使ってボードを作成、管理できます。

MCP サーバーの起動

npm からインストールした場合：

# Start only the MCP server
taskboard-mcp

# Or start both the board server and MCP server
taskboard-all

リポジトリを使用する場合：

# Start only the MCP server
./_start_mcp

# Or start both servers
./_start_all

MCP サーバーはデフォルトでポート 3002 で実行されます。

MCP サーバーの追加方法については、お使いの IDE または CLI ツールのドキュメントを参照してください。

エージェントでの使用

設定が完了したら、エージェントに次のように依頼できます：

• すべてのボードを一覧表示：「すべてのカンバンボードを表示して」
• 新しいボードを作成：「Project X という新しいカンバンボードを作成して」
• 名前を指定してボードを取得：「Project X の詳細を表示して」
• ボードを更新：「進捗に合わせて Project X ボードを更新して」
• ボードを削除：「Project X ボードを削除して」

Webhook 連携

TaskBoardAI は、他のサービスとの連携に Webhook をサポートしています：

1. ボードの更新などのイベントをトリガーとする Webhook 設定を作成します
2. API 経由で Webhook 接続をテストします
3. ボードに変更があったときにリアルタイムで更新を受け取ります

テストの実行

1. すべてのテストを実行します：

npm test

2. カバレッジレポートを生成します：

npm run test:coverage

3. ウォッチモードでテストを実行します（開発用）：

npm run test:watch

4. 特定のテストカテゴリを実行します：

# Run MCP server tests
npm test -- --testPathPattern 'tests/.*mcp'

# Run only unit tests
npm test -- tests/unit

# Run only integration tests
npm test -- tests/integration

ドキュメントの生成

ドキュメントを生成するには：

# Install dependencies (if not already installed)
npm install

# Generate docs (docs/api directory)
npm run docs

データディレクトリ

npm でインストールした場合、TaskBoardAI はユーザーデータを次の場所に保存します：

• Linux/macOS：~/.taskboardai/
• Windows：C:\Users\<username>\.taskboardai\

データディレクトリには、次のものが含まれます：

• boards/：カンバンボードの JSON ファイル
• config/：設定ファイル
• webhooks/：Webhook の設定

必要に応じて、これらのファイルに直接アクセスしたり、バックアップしたりできます。

貢献

貢献を歓迎します！ガイドラインについては、CONTRIBUTING.md をご覧ください。

ライセンス

Apache License 2.0 - 詳細は LICENSE をご覧ください。