Kanbanflow MCP Server

KanbanFlow MCP服务器

KanbanFlow的模型上下文协议（MCP）服务器-直接从Cursor/Claude管理您的电路板、任务和工作流。

🚀 快速启动（一个命令！）

🎯 推荐：自动设置

# Install globally
npm install -g kanbanflow-mcp-server

# Auto-magic setup in ANY project
cd your-project-folder
kanbanflow-mcp-server --setup

就是这样！ ✨ 安装向导将：

• 🔍 检测 自动安装
• 🛡️ 保存 您现有的任何MCP服务器
• 💾 创建备份 您的配置
• ⚙️ 生成 具有完整路径的完美配置
• 🎯 添加 KanbanFlow到您的光标设置

🛠️ 备选方案：开发人员设置

# Clone and build from source
git clone https://github.com/williamavholmberg/kanbanflow-mcp-server
cd kanbanflow-mcp-server
npm install && npm run build

# Same magic setup wizard works here too!
kanbanflow-mcp-server --setup

🔑 获取您的API代币

1. 首选 kanbanflow.com/api
2. 创建您的API令牌
3. 在安装向导提示时输入

🛡️ 安全智能配置

安装向导是 防弹的:

• ✅ 从不覆盖 您现有的MCP服务器
• ✅ 创建自动备份 在任何更改之前
• ✅ 智能合并 使用您当前的设置
• ✅ 使用可靠的路径 （无二进制问题）
• ✅ 适用于所有地方 （macOS、Windows、Linux）

示例场景：

新项目？

📝 Creating new MCP configuration file...
✅ Setup complete!

已经有MCP服务器了吗？

📋 Found existing MCP configuration with 2 server(s)
➕ Adding kanban-flow to existing configuration...
💾 Created backup: mcp.json.backup.1692123456789
✅ Setup complete!
💡 Your existing MCP servers are preserved!

是否正在更新KanbanFlow配置？

📋 Found existing MCP configuration with 3 server(s)
🔄 Updating existing kanban-flow configuration...
💾 Created backup: mcp.json.backup.1692123456789
✅ Setup complete!

🛠️ 可用工具

董事会管理

• get-board -获取您的板结构和列ID
• get-all-tasks -查看所有列中的所有任务

任务操作

• create-task -创建新任务
• get-tasks -从特定列获取任务
• get-task-details -获取详细的任务信息
• update-task -更新任务属性（名称、列、颜色等）

子任务

• add-subtask -向任何任务添加子任务
• update-subtask-by-position -按职位更新子任务
• add-subtasks -一次添加多个子任务
• create-task-with-subtasks -一次性创建任务+子任务

标签和组织

• add-label -为任务添加标签
• update-label -更新现有标签
• set-task-due-date -设定截止日期
• update-custom-field -更新自定义字段值

评论

• add-comment -向任务添加评论
• update-comment -更新现有评论

📝 使用示例

问克劳德这样的问题：

• *“显示我的董事会结构”*
• *“在待办事项列中创建一个名为“修复错误”的任务”*
• *向任务T123添加子任务：编写测试、查看代码、部署*
• *“将任务T456移至“完成”列”*
• *“我的“进行中”列中有哪些任务？”*
• *“创建一个包含3个子任务的任务，用于实现用户身份验证”*

🔧 手动配置（高级）

如果您更喜欢手动设置，向导会生成以下格式：

{
  "mcpServers": {
    "kanban-flow": {
      "command": "node",
      "args": ["/path/to/kanbanflow-mcp-server/build/index.js"],
      "env": {
        "KANBAN_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

🚀 发展

# Build
npm run build

# Help
kanbanflow-mcp-server --help

# Test (requires KANBAN_API_TOKEN env var)
npm run dev

🎯 为什么此MCP服务器性能不佳

• 🪄 一个命令设置 -无需手动编辑配置
• 🛡️ 防弹安全 -永远不要破坏您现有的设置
• 🎯 智能检测 -适用于任何安装方法
• 🔄 可重新运行 -随时安全地更新配置
• 📱 跨平台 -macOS、Windows、Linux
• 🚀 行业领先的用户体验 -MCP设置的工作方式

📄 许可证

MIT许可证-请参阅 许可证 文件。

🤝 贡献

1. 分叉回购
2. 创建功能分支
3. 进行更改
4. 使用您的KanbanFlow板进行测试
5. 提交拉取请求

______________________________________________________________________

需要帮助？ 打开一个问题！

💡 专业提示： 跑 kanbanflow-mcp-server --setup 随时安全更新配置！