Kanban MCP

🚀 MCP 看板

MCP 看板是一種 MCP 工具集，專為複雜多會話工作流中的 AI 代理設計，可提供內部任務管理狀態。它與其他記憶 MCP 工具類似，但增添了看板式任務管理系統的結構、規則和可見性，能指導 AI 代理在看板中記錄和保存工作，無論是會議計劃還是執行階段都適用。

✨ 主要特性

• 列容量 / 工作進度限制
• 嵌入式數據庫 (SQLite)
• 具備觀察工作進展和手動修改任務功能的 Web UI
• 用於開始和恢復工作流的預定義提示

🚀 快速開始

使用 MCP 提示詞即可啟動一個項目或推動項目進展。也能讓大語言模型助手通過創建看板來記錄其計劃。若要在後續會議中繼續工作，指示助手定位特定的看板並恢復工作即可。

📦 安裝指南

常規安裝

1. 克隆此倉庫，然後執行以下命令：

npm ci --prefix shared/db
npm ci --prefix mcp-server
npm run build --prefix shared/db
npm run build --prefix mcp-server

2. 將 MCP 服務器配置添加到 MCP 客戶端（例如 Claude Desktop）中：

"mcpServers": {
    "kanban-mcp": {
        "command": "node",
        "args": [
            "/path/to/repo/mcp-server/dist/server.js"
        ],
        "env": {
            "MCP_KANBAN_DB_FOLDER_PATH": "/path/to/db"
        }
    }
}

請將 /path/to/repo 替換為克隆倉庫的實際路徑，將 /path/to/db 替換為您希望包含 DB 文件的文件夾，該文件夾需具備讀寫權限，若不存在則會自動創建。

使用 Docker 安裝

1. 構建 Docker 鏡像：

docker build -t mcp/mcp-kanban .

2. 將 MCP 服務器配置添加到 MCP 客戶端（例如 Claude Desktop）中：

"mcpServers": {
    "kanban-mcp": {
        "command": "docker",
        "args": [
            "run",
            "--rm",
            "-i",
            "-v",
            "/path/to/db:/mcp",
            "mcp/mcp-kanban"
        ]
    }
}

請將 /path/to/db 替換為您希望包含 DB 文件的文件夾，該文件夾需具備讀寫權限。

使用 Web UI

1. 構建 Web 界面和 Web 服務器：

npm ci --prefix shared/db
npm run build --prefix shared/db

npm ci --prefix web-ui
npm ci --prefix web-server
npm run build --prefix web-ui
npm run build --prefix web-server

2. 運行 Web 服務器：

node server.js

3. 在瀏覽器中訪問 http://localhost:3000。

💻 使用示例

基礎用法

以下是使用 API 工具的基礎示例：

創建看板

# 使用 POST /kanban 創建新的看板
curl -X POST http://localhost:3000/kanban

獲取所有看板

# 使用 GET /kanban 獲取所有看板列表
curl -X GET http://localhost:3000/kanban

更新任務狀態

# 使用 PUT /kanban/{boardId}/task/{taskId} 更新特定任務的狀態
curl -X PUT http://localhost:3000/kanban/123/task/456

高級用法

基於看板創建項目

通過創建一個看板，提出問題將項目分解為任務，並將其添加到看板中。例如，使用大語言模型助手創建看板並添加任務：

# 假設使用某種方式調用大語言模型助手創建看板並添加任務
# 這裡只是示意，具體實現根據實際情況而定

在現有項目上取得進展

定位其看板，選擇下一個任務並進行處理。例如，通過 API 定位看板並獲取下一個任務：

# 假設通過 API 獲取看板信息並選擇下一個任務
# 這裡只是示意，具體實現根據實際情況而定

📚 詳細文檔

API 工具

工具

• 創建看板：使用 POST /kanban 創建新的看板。
• 獲取所有看板：使用 GET /kanban 獲取所有看板列表。
• 更新任務狀態：使用 PUT /kanban/{boardId}/task/{taskId} 更新特定任務的狀態。

提示

• 基於看板創建項目：通過創建一個看板，提出問題將項目分解為任務，並將其添加到看板中。
• 在現有項目上取得進展：定位其看板，選擇下一個任務並進行處理。