Viban

🚀 Viban

一款集成MCP服務器的看板，用於人工智能輔助任務管理

Viban是一個輕量級的TypeScript看板，它通過模型上下文協議（MCP）與人工智能編碼助手集成。它使Claude、Cursor或Antigravity等人工智能工具能夠以編程方式管理開發任務。本項目在Antigravity（Opus 4.5 + Gemini 3 Flash）的人工智能支持下編寫。

✨ 主要特性

• 🎯 四個看板列：待辦事項積壓 → 待辦 → 審核 → 已完成
• 🌐 Web用戶界面：可在http://localhost:3000 訪問可視化看板
• 🌙 淺色/深色模式：可在不同主題之間切換
• 🤖 MCP服務器：提供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資源

人工智能工作流程示例

1. 人工智能獲取當前任務：

"Show me the current TODO tasks"
→ 調用 get_todo_tasks

2. 人工智能處理任務：

"Work on task: Implement login functionality"
→ 人工智能實現該功能

3. 人工智能標記任務以供審核：

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

🔧 技術細節

開發

# 安裝依賴
npm install

# 在開發模式下運行
npm run dev -- /path/to/project

# 運行測試
npm test

# 構建生產版本
npm run build

項目結構

viban/
├── src/
│   ├── index.ts          # CLI入口點
│   ├── mcp-server.ts     # MCP服務器實現
│   ├── board/
│   │   ├── types.ts      # TypeScript接口
│   │   ├── board.ts      # 看板管理邏輯
│   │   └── storage.ts    # JSON文件存儲
│   └── config/
│       └── config.ts     # YAML配置解析器
├── package.json
├── tsconfig.json
├── Dockerfile
├── docker-compose.yml
└── README.md

📄 許可證

MIT