Kanboard MCP

探索

Kanboard MCP

Kanboard MCP服務器是一個基於Go語言開發的模型上下文協議服務器，實現AI助手與Kanboard項目管理系統的無縫集成，支持通過自然語言命令管理項目、任務、用戶和工作流。

開發者工具知識管理與記憶 #項目管理 #任務管理 #AI集成 #工作流自動化 .Go

評分 : 2.5分

下載量 : 4.7K

更新時間 : 2025-07-24

打開站點

什麼是Kanboard MCP服務器？

Kanboard MCP服務器是一個基於Go語言開發的Model Context Protocol (MCP)服務端程序，它允許AI助手（如Claude Desktop、Cursor）通過自然語言直接與Kanboard項目管理系統進行交互。用戶可以通過簡單的中文指令管理項目、任務、用戶和工作流。

如何使用Kanboard MCP服務器？

只需配置Kanboard的API信息並設置MCP客戶端即可使用。該服務器支持多種操作，包括創建項目、管理任務、分配用戶等，所有操作都可以通過自然語言完成。

適用場景

適用於需要將AI助手與Kanboard集成的團隊，用於快速創建和管理項目、任務以及協作流程。特別適合希望用自然語言控制項目管理系統的用戶。

主要功能

自然語言項目管理

通過簡單對話即可創建、更新或刪除項目，無需複雜命令

任務管理

支持創建、分配、更新和刪除任務，並可設置截止日期和優先級

用戶和權限管理

可以添加、移除用戶，併為他們分配不同的項目角色

多平臺兼容性

與Cursor、Claude Desktop等MCP客戶端兼容，可在多種環境中使用

安全認證

支持API密鑰和用戶名/密碼兩種認證方式，確保數據安全

即時同步

與Kanboard即時同步數據，確保所有更改立即生效

優勢

通過自然語言簡化項目管理操作

提高工作效率，減少手動輸入

支持多種MCP客戶端，便於集成到現有系統

提供豐富的API接口，易於擴展

侷限性

需要Kanboard API訪問權限才能使用

初期配置可能對非技術用戶有一定難度

某些高級功能可能需要額外配置

如何使用

安裝服務器

克隆倉庫並編譯Go代碼，生成可執行文件。

配置環境變量

設置Kanboard的API端點和認證信息。

配置MCP客戶端

在MCP客戶端中指定服務器路徑和環境變量。

啟動服務

運行編譯後的可執行文件，等待MCP客戶端連接。

使用案例

創建項目並分配任務

用戶可以通過簡單的自然語言創建項目並分配任務，例如：'創建項目 '移動應用開發' 並添加任務 '設計UI原型' 和 '設置開發環境'。'

管理任務狀態

用戶可以輕鬆地將任務的狀態從 '待辦' 改為 '進行中' 或 '已完成'，例如：'將任務 123 移動到 '進行中' 列'。

管理用戶權限

用戶可以添加新成員到項目中，例如：'將用戶 'alice.smith' 添加到 '移動應用開發' 項目中作為 '項目成員'。'

常見問題

如何解決MCP客戶端連接失敗的問題？

如何獲取Kanboard的API密鑰？

如果遇到錯誤提示 '代理錯誤'，該怎麼辦？

是否支持多語言操作？

如何更新Kanboard MCP服務器？

🚀 Kanboard MCP 服務器

這是一個強大的基於 Go 語言的 Model Context Protocol (MCP) 服務器，可實現 AI 助手（如 Claude Desktop、Cursor）與 Kanboard 項目管理系統的無縫集成。你可以直接通過自然語言命令來管理 Kanboard 項目、任務、用戶和工作流。

⚠️ 重要提示

為避免出現以下問題：

我們建議使用 mcpproxy 作為代理解決方案。

📋 目錄

✨ 主要特性
🚀 快速開始
⚙️ 配置
🛠️ 可用工具
📖 使用示例
🔧 開發
📄 許可證

✨ 主要特性

🔗 與 Kanboard 無縫集成 - 直接通過 API 與 Kanboard 進行通信
🤖 自然語言處理 - 使用簡單的英語來管理項目
📊 全面的項目管理 - 處理項目、任務、用戶、列等更多內容
🔐 安全認證 - 支持 API 密鑰和用戶名/密碼兩種認證方式
⚡ 高性能 - 採用 Go 語言構建，性能卓越
🎯 符合 MCP 標準 - 與所有 MCP 客戶端兼容

🚀 快速開始

前提條件

Go 1.21 或更高版本
具有 API 訪問權限的 Kanboard 實例
兼容 MCP 的客戶端（如 Cursor、Claude Desktop 等）

安裝

克隆倉庫：

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

構建可執行文件：

在 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 等）以使更改生效。

🛠️ 可用工具

📁 項目管理

工具	描述	示例
`get_projects`	📋 列出所有項目	"顯示所有 Kanboard 項目"
`create_project`	➕ 創建新項目	"創建一個名為 '網站重新設計' 的項目，描述為 '重新設計公司網站'，所有者為 1"
`get_project_by_id`	🔍 通過 ID 獲取項目信息	"獲取 ID 為 123 的項目詳情"
`get_project_by_name`	🔍 通過名稱獲取項目信息	"獲取名為 '我的項目' 的項目詳情"
`get_project_by_identifier`	🔍 通過標識符獲取項目信息	"獲取標識符為 'WEB-APP' 的項目詳情"
`get_project_by_email`	🔍 通過電子郵件獲取項目信息	"獲取電子郵件為 'project@example.com' 的項目詳情"
`get_all_projects`	📋 獲取所有可用項目	"顯示所有可用項目"
`update_project`	✏️ 更新項目	"將項目 1 的名稱更新為 '新網站'，描述更新為 '更新後的描述'"
`remove_project`	🗑️ 刪除項目	"刪除 ID 為 456 的項目"
`enable_project`	✅ 啟用項目	"啟用項目 123"
`disable_project`	🚫 禁用項目	"禁用項目 123"
`enable_project_public_access`	🌐 啟用項目的公共訪問權限	"啟用項目 123 的公共訪問權限"
`disable_project_public_access`	🔒 禁用項目的公共訪問權限	"禁用項目 123 的公共訪問權限"
`get_project_activity`	📢 獲取項目的活動流	"顯示項目 123 的活動"
`get_project_activities`	📊 獲取項目的活動源	"獲取項目 1、2 和 3 的活動"

📝 任務管理

工具	描述	示例
`get_tasks`	📋 獲取項目任務	"獲取 '網站重新設計' 項目的任務"
`create_task`	➕ 創建新任務	"在 '網站重新設計' 項目中創建任務 '設計主頁'"
`update_task`	✏️ 修改現有任務	"將任務 123 的描述更新為 '新需求'"
`delete_task`	🗑️ 刪除任務	"刪除 ID 為 456 的任務"
`get_task`	🔍 通過唯一 ID 獲取任務	"獲取任務 789 的詳情"
`get_task_by_reference`	🔍 通過外部引用獲取任務	"獲取項目 1 中引用為 'TICKET-1234' 的任務"
`get_all_tasks`	📋 獲取所有可用任務	"獲取項目 1 的所有活躍任務"
`get_overdue_tasks`	⏰ 獲取所有逾期任務	"顯示所有逾期任務"
`get_overdue_tasks_by_project`	⏰ 獲取特定項目的所有逾期任務	"顯示項目 1 的逾期任務"
`open_task`	✅ 將任務狀態設置為打開	"打開任務 123"
`close_task`	❌ 將任務狀態設置為關閉	"關閉任務 123"
`move_task_position`	➡️ 在同一看板內將任務移動到另一列、位置或泳道	"將任務 123 移動到項目 1 的第 2 列、第 1 個位置、第 1 個泳道"
`move_task_to_project`	➡️ 將任務移動到另一個項目	"將任務 123 移動到項目 456"
`duplicate_task_to_project`	📋 將任務複製到另一個項目	"將任務 123 複製到項目 456"
`search_tasks`	🔍 使用搜索引擎查找任務	"在項目 2 中搜索查詢 '分配人:無人' 的任務"
`assign_task`	👤 將任務分配給用戶	"將 API 任務分配給 John"
`set_task_due_date`	📅 設置任務截止日期	"將登錄任務的截止日期設置為 2024-01-15"

💬 評論管理

工具	描述	示例
`create_comment`	➕ 創建新評論	"為任務 123 創建一條評論 '會議記錄'，由用戶 1 發佈，對應用管理員可見"
`get_task_comments`	📋 獲取任務評論	"顯示任務 123 的所有評論"
`get_comment`	🔍 獲取評論信息	"獲取評論 789 的詳情"
`update_comment`	✏️ 更新評論	"將評論 456 的內容更新為 '修訂後的記錄'"
`remove_comment`	🗑️ 刪除評論	"刪除 ID 為 101 的評論"

🏗️ 列管理

工具	描述	示例
`get_columns`	📋 列出項目列	"顯示項目 123 的所有列"
`get_column`	🔍 獲取單個列	"獲取列 456 的詳情"
`create_column`	➕ 添加新列	"在項目 123 中創建一個 '測試' 列，任務限制為 5 個，描述為 '用於用戶驗收測試'"
`update_column`	✏️ 修改列設置	"將列 123 的標題更改為 '審核'，任務限制為 3 個，描述為 '需要最終審核'"
`change_column_position`	🔄 更改列的位置	"將列 123 移動到項目 456 的第 3 個位置"
`delete_column`	🗑️ 刪除列	"刪除未使用的 '草稿' 列"

🏷️ 類別管理

工具	描述	示例
`get_categories`	📋 列出項目類別	"顯示項目 123 的所有任務類別"
`get_category`	🔍 獲取類別信息	"獲取類別 456 的詳情"
`create_category`	➕ 添加任務類別	"在項目 123 中創建一個 '漏洞修復' 類別，顏色為 '紅色'"
`update_category`	✏️ 修改類別	"將類別 123 重命名為 '關鍵問題'，顏色設置為 '藍色'"
`delete_category`	🗑️ 刪除類別	"刪除未使用的 '存檔' 類別"

🏊 泳道管理

工具	描述	示例
`get_swimlanes`	📋 列出項目的所有泳道（啟用或禁用），並按位置排序	"顯示項目 1 的所有泳道"
`get_active_swimlanes`	📋 獲取項目的啟用泳道列表（如果啟用了默認泳道則包含在內）	"獲取項目 1 的活躍泳道"
`get_swimlane`	🔍 通過 ID 獲取泳道	"獲取 ID 為 1 的泳道詳情"
`get_swimlane_by_id`	🔍 通過 ID 獲取泳道	"獲取 ID 為 1 的泳道詳情"
`get_swimlane_by_name`	🔍 通過名稱獲取泳道	"獲取項目 1 中名為 '泳道 1' 的泳道詳情"
`change_swimlane_position`	🔄 移動泳道的位置（僅適用於活躍泳道）	"將項目 1 中泳道 2 的位置更改為 3"
`create_swimlane`	➕ 添加新泳道	"在項目 1 中創建一個 '前端團隊' 泳道"
`update_swimlane`	✏️ 更新泳道屬性	"將項目 1 中泳道 1 的名稱更新為 '跨平臺團隊'"
`remove_swimlane`	🗑️ 刪除泳道	"從項目 2 中刪除泳道 1"
`disable_swimlane`	🚫 禁用泳道	"從項目 2 中禁用泳道 1"
`enable_swimlane`	✅ 啟用泳道	"從項目 2 中啟用泳道 1"

📋 看板管理

工具	描述	示例
`get_board`	📋 獲取顯示看板所需的所有信息	"顯示項目 123 的看板"

🧑‍💻 當前用戶管理

工具	描述	示例
`get_me`	👤 獲取當前登錄用戶的會話信息	"獲取我的用戶會話信息"
`get_my_dashboard`	📊 獲取當前登錄用戶的儀表盤	"顯示我的儀表盤"
`get_my_activity_stream`	📢 獲取當前登錄用戶的最後 100 個事件	"顯示我的近期活動"
`create_my_private_project`	➕ 為當前登錄用戶創建一個私人項目	"創建一個名為 '我的秘密項目' 的私人項目，描述為 '用於個人任務'"
`get_my_projects_list`	📋 獲取當前登錄用戶參與的項目	"列出我參與的所有項目"
`get_my_overdue_tasks`	⏰ 獲取當前登錄用戶的逾期任務	"顯示我所有逾期的任務"
`get_my_projects`	📝 獲取當前登錄用戶參與的項目的詳細信息	"獲取我所有項目的詳細信息"

🔗 外部任務鏈接管理

工具	描述	示例
`get_external_task_link_types`	📋 獲取所有已註冊的外部鏈接提供程序	"顯示所有外部鏈接類型"
`get_ext_link_provider_deps`	⛓️ 獲取給定提供程序的可用依賴項	"獲取 'weblink' 提供程序的依賴項"
`create_external_task_link`	➕ 創建新的外部鏈接	"為任務 123 創建一個外部鏈接到 'http://example.com/doc.pdf'，依賴項為 '相關'，類型為 '附件'"
`update_external_task_link`	✏️ 更新外部任務鏈接	"將任務 789 的外部鏈接 456 的標題更新為 '更新後的文檔'，URL 更新為 'http://new.example.com/doc.pdf'"
`get_external_task_link_by_id`	🔍 通過 ID 獲取外部任務鏈接	"獲取任務 789 的外部鏈接 456"
`get_all_external_task_links`	📋 獲取附加到任務的所有外部鏈接	"顯示任務 123 的所有外部鏈接"
`remove_external_task_link`	🗑️ 刪除外部鏈接	"從任務 789 中刪除外部鏈接 456"

🔗 內部任務鏈接管理

工具	描述	示例
`create_task_link`	➕ 在兩個任務之間創建鏈接	"在任務 123 和任務 456 之間創建一個鏈接類型為 1 的鏈接"
`update_task_link`	✏️ 更新任務鏈接	"將任務 123 和任務 456 之間的任務鏈接 789 的鏈接類型更新為 2"
`get_task_link_by_id`	🔍 通過 ID 獲取任務鏈接	"獲取任務鏈接 101 的詳情"
`get_all_task_links`	📋 獲取與任務相關的所有鏈接	"顯示任務 123 的所有鏈接"
`remove_task_link`	🗑️ 刪除兩個任務之間的鏈接	"刪除任務鏈接 101"

🔗 鏈接管理

工具	描述	示例
`get_all_links`	📋 獲取任務之間可能的關係列表	"顯示所有可能的任務關係"
`get_opposite_link_id`	🔍 獲取任務鏈接的相反鏈接 ID	"獲取鏈接 2 的相反鏈接 ID"
`get_link_by_label`	🔍 通過標籤獲取鏈接	"獲取標籤為 '阻塞' 的鏈接詳情"
`get_link_by_id`	🔍 通過 ID 獲取鏈接	"獲取 ID 為 4 的鏈接詳情"
`create_link`	➕ 創建新的任務關係	"創建一個鏈接 'foo'，相反標籤為 'bar'"
`update_link`	✏️ 更新鏈接	"將鏈接 14 的相反鏈接更新為 12，標籤更新為 'boo'"
`remove_link`	🗑️ 刪除鏈接	"刪除 ID 為 14 的鏈接"

📂 項目文件管理

工具	描述	示例
`create_project_file`	➕ 創建並上傳新的項目附件	"為項目 1 創建一個名為 '我的文檔.pdf' 的文件，Base64 內容為 'Zm9vYmFy'"
`get_all_project_files`	📋 獲取附加到項目的所有文件	"顯示項目 123 的所有文件"
`get_project_file`	🔍 獲取文件信息	"獲取項目 123 中文件 456 的詳情"
`download_project_file`	📥 下載項目文件內容（Base64 編碼）	"從項目 123 下載文件 456"
`remove_project_file`	🗑️ 刪除與項目關聯的文件	"從項目 123 中刪除文件 456"
`remove_all_project_files`	🗑️ 刪除與項目關聯的所有文件	"從項目 123 中刪除所有文件"

📝 項目元數據管理

工具	描述	示例
`get_project_metadata`	📋 獲取項目元數據	"獲取項目 123 的所有元數據"
`get_project_metadata_by_name`	🔍 獲取單個元數據值	"獲取項目 123 的元數據 'my_key'"
`save_project_metadata`	💾 添加或更新元數據	"為項目 123 保存元數據 'key1:value1, key2:value2'"
`remove_project_metadata`	🗑️ 刪除項目元數據	"從項目 123 中刪除元數據 'my_key'"

🔐 項目權限管理

工具	描述	示例
`get_project_users`	📋 獲取項目的所有成員	"顯示項目 123 的所有用戶"
`get_assignable_users`	👥 獲取可分配到項目任務的用戶（除查看者外的所有成員）	"獲取項目 123 的可分配用戶"
`add_project_user`	➕ 授予用戶對項目的訪問權限	"將用戶 1 添加到項目 123 中，角色為 '項目成員'"
`add_project_group`	➕ 授予組對項目的訪問權限	"將組 456 添加到項目 123 中，角色為 '項目查看者'"
`remove_project_user`	🗑️ 撤銷用戶對項目的訪問權限	"從項目 123 中移除用戶 1"
`remove_project_group`	🗑️ 撤銷組對項目的訪問權限	"從項目 123 中移除組 456"
`change_project_user_role`	✏️ 更改用戶在項目中的角色	"將用戶 1 在項目 123 中的角色更改為 '項目管理員'"
`change_project_group_role`	✏️ 更改組在項目中的角色	"將組 456 在項目 123 中的角色更改為 '項目管理員'"
`get_project_user_role`	🔍 獲取用戶在給定項目中的角色	"獲取用戶 1 在項目 123 中的角色"

📝 子任務管理

工具	描述	示例
`create_subtask`	➕ 創建新的子任務	"為任務 123 創建一個子任務 '審核設計'，分配給用戶 1"
`get_subtask`	🔍 獲取子任務信息	"獲取子任務 456 的詳情"
`get_all_subtasks`	📋 獲取任務的所有可用子任務	"顯示任務 123 的所有子任務"
`update_subtask`	✏️ 更新子任務	"將任務 123 的子任務 456 的狀態更新為 2（已完成）"
`remove_subtask`	🗑️ 刪除子任務	"刪除 ID 為 456 的子任務"

⏰ 子任務時間跟蹤

工具	描述	示例
`has_subtask_timer`	⏱️ 檢查給定子任務和用戶的計時器是否已啟動	"檢查用戶 4 對子任務 123 的計時器是否處於活動狀態"
`set_subtask_start_time`	▶️ 為用戶啟動子任務計時器	"用戶 4 啟動子任務 123 的計時器"
`set_subtask_end_time`	⏹️ 為用戶停止子任務計時器	"用戶 4 停止子任務 123 的計時器"
`get_subtask_time_spent`	📊 獲取用戶在子任務上花費的時間	"獲取用戶 4 在子任務 123 上花費的時間"

🏷️ 標籤管理

工具	描述	示例
`get_all_tags`	📋 獲取所有標籤	"顯示所有可用標籤"
`get_tags_by_project`	📋 獲取給定項目的所有標籤	"顯示項目 123 的標籤"
`create_tag`	➕ 創建新標籤	"為項目 123 創建標籤 '後端'，顏色為 1"
`update_tag`	✏️ 重命名標籤	"將標籤 456 重命名為 '前端'，顏色設置為 2"
`remove_tag`	🗑️ 刪除標籤	"刪除 ID 為 456 的標籤"
`set_task_tags`	🏷️ 為任務分配/創建/更新標籤	"為項目 456 中的任務 123 設置標籤 '緊急'、'漏洞'"
`get_task_tags`	🔍 獲取分配給任務的標籤	"獲取任務 123 分配的標籤"

📂 任務文件管理

工具	描述	示例
`create_task_file`	➕ 創建並上傳新的任務附件	"為項目 1 中的任務 2 創建一個名為 '會議記錄.txt' 的文件，Base64 內容為 'Zm9vYmFy'"
`get_all_task_files`	📋 獲取附加到任務的所有文件	"顯示任務 123 的所有文件"
`get_task_file`	🔍 獲取文件信息	"獲取文件 456 的詳情"
`download_task_file`	📥 下載文件內容（Base64 編碼）	"下載文件 456"
`remove_task_file`	🗑️ 刪除文件	"刪除 ID 為 456 的文件"
`remove_all_task_files`	🗑️ 刪除與任務關聯的所有文件	"從任務 123 中刪除所有文件"

📝 任務元數據管理

工具	描述	示例
`get_task_metadata`	📋 通過任務唯一 ID 獲取與任務相關的所有元數據	"獲取任務 1 的所有元數據"
`get_task_metadata_by_name`	🔍 通過任務唯一 ID 和元鍵（名稱）獲取與任務相關的元數據	"獲取任務 1 的元數據 'metaKey1'"
`save_task_metadata`	💾 保存/更新任務元數據	"為任務 1 保存元數據 'metaName:metaValue'"
`remove_task_metadata`	🗑️ 按名稱刪除任務元數據	"從任務 1 中刪除元數據 'metaKey1'"

⚙️ 應用程序管理

工具	描述	示例
`get_version`	📋 獲取應用程序版本	"Kanboard 的版本是多少？"
`get_timezone`	🌐 獲取當前登錄用戶的時區	"我當前的時區是什麼？"
`get_default_task_colors`	🌈 獲取所有默認任務顏色	"顯示所有默認任務顏色"
`get_default_task_color`	🎨 獲取默認任務顏色	"默認任務顏色是什麼？"
`get_color_list`	📋 獲取任務顏色列表	"列出所有可用的任務顏色"
`get_application_roles`	👥 獲取應用程序角色	"列出所有應用程序角色"
`get_project_roles`	👥 獲取項目角色	"列出所有項目角色"

🤖 自動操作管理

工具	描述	示例
`get_available_actions`	📋 獲取可用的自動操作列表	"顯示可用的自動操作"
`get_available_action_events`	📋 獲取操作的可用事件列表	"顯示可用的操作事件"
`get_compatible_action_events`	🔍 獲取與操作兼容的事件列表	"獲取與操作 'TaskClose' 兼容的事件"
`get_actions`	📋 獲取項目的操作列表	"獲取項目 123 的操作"
`create_action`	➕ 創建操作	"為項目 1 創建一個操作，事件為 'task.move.column'，操作為 '\Kanboard\Action\TaskClose'，參數為 'column_id:3'"
`remove_action`	🗑️ 刪除操作	"刪除 ID 為 456 的操作"

👥 組管理

工具	描述	示例
`create_group`	➕ 創建新組	"創建一個名為 '開發團隊' 的組，外部 ID 為 'dev_001'"
`update_group`	✏️ 更新組	"將組 123 重命名為 'QA 團隊'，並將其外部 ID 更改為 'qa_001'"
`remove_group`	🗑️ 刪除組	"刪除 ID 為 456 的組"
`get_group`	🔍 獲取一個組	"獲取組 789 的詳情"
`get_all_groups`	📋 獲取所有組	"顯示所有用戶組"

👥 組成員管理

工具	描述	示例
`get_member_groups`	📋 獲取給定用戶所屬的所有組	"顯示用戶 1 所屬的所有組"
`get_group_members`	👥 獲取組的所有成員	"列出組 123 的所有成員"
`add_group_member`	➕ 將用戶添加到組中	"將用戶 456 添加到組 789 中"
`remove_group_member`	🗑️ 從組中移除用戶	"從組 789 中移除用戶 456"
`is_group_member`	❓ 檢查用戶是否為組的成員	"用戶 456 是否為組 789 的成員？"

👥 用戶管理

工具	描述	示例
`get_users`	📋 列出所有系統用戶	"顯示所有用戶"
`create_user`	➕ 創建新用戶	"創建用戶 'john'，密碼為 '123456'"
`create_ldap_user`	➕ 創建通過 LDAP 認證的新用戶	"創建 LDAP 用戶 'jane'"
`get_user`	🔍 通過 ID 獲取用戶信息	"獲取 ID 為 123 的用戶詳情"
`get_user_by_name`	🔍 通過用戶名獲取用戶信息	"獲取用戶 'john' 的詳情"
`update_user`	✏️ 更新用戶信息	"將用戶 123 的角色更新為 '應用管理員'"
`remove_user`	🗑️ 刪除用戶	"刪除 ID 為 456 的用戶"
`disable_user`	❌ 禁用用戶	"禁用用戶 123"
`enable_user`	✅ 啟用用戶	"啟用用戶 123"
`is_active_user`	🔍 檢查用戶是否活躍	"檢查用戶 123 是否活躍"
`assign_user_to_project`	👤 將用戶分配到項目中，並指定特定角色	"將用戶 1 分配到項目 '網站' 中，角色為 '項目成員'"

🏃 ScrumSprint 插件 API

工具	描述	示例
`create_sprint`	➕ 創建新的衝刺	"在項目 '我的項目' 中創建一個名為 '衝刺 1' 的衝刺，開始時間為 '2024-01-01'，結束時間為 '2024-01-14'，目標為 '完成入職功能'"
`get_sprint_by_id`	🔍 通過 ID 檢索衝刺	"獲取 ID 為 123 的衝刺詳情"
`update_sprint`	✏️ 更新現有的衝刺	"將項目 '我的項目' 中的衝刺 123 更新為已完成"
`remove_sprint`	🗑️ 通過 ID 刪除衝刺	"刪除 ID 為 123 的衝刺"
`get_all_sprints_by_project`	📋 檢索給定項目的所有衝刺	"獲取項目 '我的項目' 的所有衝刺"

📖 使用示例

項目工作流

# 創建新項目
"創建一個名為 '移動應用開發' 的新項目"

# 向項目中添加任務
"在項目 '移動應用開發' 中創建任務 '設計 UI 原型'"
"在項目 '移動應用開發' 中創建任務 '設置開發環境'"

# 獲取所有任務
"獲取 '移動應用開發' 項目的任務"

# 在列之間移動任務
"將任務 1 移動到 '進行中' 列"
"將任務 2 移動到 '已完成' 列"

團隊管理

# 創建新團隊成員
"創建用戶 'alice.smith'，密碼為 'secure123'，電子郵件為 'alice@company.com'"

# 將用戶分配到項目
"將用戶 'alice.smith' 分配到項目 '移動應用開發' 中，角色為項目成員"

# 將任務分配給團隊成員
"將任務 1 分配給用戶 'alice.smith'"

任務組織

# 創建類別以更好地組織任務
"創建類別 '關鍵漏洞'"
"創建類別 '功能請求'"

# 為任務添加評論
"為任務 5 添加評論 '這需要緊急關注'"

# 設置截止日期
"將任務 3 的截止日期設置為 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           # 許可證信息