Viban

🚀 Viban

AI支援型タスク管理のためのMCPサーバー統合付きカンバンボード

Vibanは、Model Context Protocol (MCP) を介してAIコーディングアシスタントと統合された軽量のTypeScript製カンバンボードです。Claude、Cursor、AntigravityなどのAIツールが開発タスクをプログラム的に管理できるようになります。このプロジェクトは、Antigravity (Opus 4.5 + Gemini 3 Flash) によるAI支援を受けてコーディングされています。

✨ 主な機能

• 🎯 4つのカンバンカラム：Backlog → Todo → Review → Done
• 🌐 Web UI：http://localhost:3000 で視覚的なボードを表示
• 🌙 ライト/ダークモード：テーマを切り替えることができます
• 🤖 MCPサーバー：AI統合のための9つのツール
• 📁 ファイルベースのストレージ：タスクはJSONに、設定はYAMLに保存されます
• ⚡ 軽量：データベースは不要です

🚀 クイックスタート

オプション1: ローカルで実行 (npm)

# リポジトリをクローン
git clone https://github.com/yourusername/viban.git
cd viban

# 依存関係をインストール
npm install

# ビルド
npm run build

# 対話的に実行 (プロジェクトパスを入力するように促されます)
node dist/index.js

# またはMCPサーバーとして実行 (最後に選択したプロジェクトまたは現在のディレクトリを使用)
node dist/index.js --mcp

オプション3: 開発モード

# 開発モードで実行 (対話的)
npm run dev

# または開発モードでMCPサーバーとして実行
npm run dev -- --mcp

📚 ドキュメント

設定

Vibanは、プロジェクトディレクトリ内の .config-viban.yml に設定を保存します。

boardName: "My Project"
tasksFile: "tasks.json"
createdAt: "2026-01-11T11:20:30+01:00"

タスクは tasks.json に保存されます。

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Implement user authentication",
    "description": "Add login/logout functionality",
    "column": "todo",
    "priority": "high",
    "createdAt": "2026-01-11T11:20:30+01:00",
    "updatedAt": "2026-01-11T11:20:30+01:00"
  }
]

MCP統合

Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "viban": {
      "command": "node",
      "args": ["/absolute/path/to/viban/dist/index.js", "--mcp"],
      "env": {
        "VIBAN_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Cursor

MCP設定に以下を追加します。

{
  "viban": {
    "command": "node",
    "args": ["/absolute/path/to/viban/dist/index.js", "--mcp"],
    "env": {
      "VIBAN_PROJECT_PATH": "/path/to/your/project"
    }
  }
}

Antigravity

AntigravityのMCP設定に以下を追加します。

{
  "mcpServers": {
    "viban": {
      "command": "node",
      "args": [
        "c:/Users/Seb/Documents/viban/dist/index.js",
        "--mcp"
      ],
      "env": {
        "VIBAN_PROJECT_PATH": "C:/Users/Seb/Documents/viban_test"
      }
    }
  }
}

⚠️ 重要提示

MCPサーバーは VIBAN_PROJECT_PATH 環境変数を使用し、それがない場合は対話モードで最後に選択したプロジェクトパスを使用します。

利用可能なMCPツール

利用可能なMCPリソース

AIワークフローの例

1. AIが現在のタスクを取得する

   "Show me the current TODO tasks"
   → Calls get_todo_tasks
   

2. AIがタスクに取り組む

   "Work on task: Implement login functionality"
   → AI implements the feature
   

3. AIがタスクをレビュー対象にする

   "I've completed the task, move it to review"
   → Calls move_to_review(id)
   

開発

# 依存関係をインストール
npm install

# 開発モードで実行
npm run dev -- /path/to/project

# テストを実行
npm test

# 本番用にビルド
npm run build

プロジェクト構造

viban/
├── src/
│   ├── index.ts          # CLI entry point
│   ├── mcp-server.ts     # MCP server implementation
│   ├── board/
│   │   ├── types.ts      # TypeScript interfaces
│   │   ├── board.ts      # Board management logic
│   │   └── storage.ts    # JSON file storage
│   └── config/
│       └── config.ts     # YAML config parser
├── package.json
├── tsconfig.json
├── Dockerfile
├── docker-compose.yml
└── README.md

📄 ライセンス

MIT