看板管理服务

一个基于Rhizome仓库的轻量级看板管理服务,支持卡片操作和自动化钩子,适用于项目管理和任务跟踪。

  • by Unity-Environmental-University
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Unity-Environmental-University/rhizome-kanban-mcp

使用说明

根茎看板mcp

保持面向人的看板的最小MCP(模型上下文协议)服务器 在Rhizome存储库旁边的板上。角色和人工操作员可以 通过添加/移动/完成卡片 rhizome mcp 命令或任何MCP兼容客户端。 状态以JSON格式存储在 .rhizome/kanban/ 钩子允许进一步 自动化(例如通知、与其他系统同步)。

特性

  • 建议的默认列: 待办事项→ 进行中→ 审查→ Done
  • JSON支持板(.rhizome/kanban/board.json)--没有外部数据库。
  • 工具:
    • kanban.list_board --看看列和卡片。
    • kanban.add_card --创建带有标签/链接/元数据的工作项。
    • kanban.move_card --跨列移动。
    • kanban.complete_card --标记完成(移动到 Done).
    • kanban.prune_done --丢弃过期的已完成卡片。
    • kanban.import_flight --种子卡来自Rhizome飞行计划步骤。
    • kanban.sync_git --总结 git status 进入积压卡。
  • 钩子支持:可执行文件 .rhizome/kanban/hooks.d 被调用 带有JSON有效载荷的突变(event, card等等)。
  • 可通过以下方式安装 rhizome mcp plugin install https://github.com/unity-edu/rhizome-kanban-mcp.git.

快速开始

# clone this repo somewhere reachable
cd /path/to/rhizome-kanban-mcp

# list tools (stdio one-shot)
printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | ./bin/kanban-mcp

# integrate with rhizome (from your target repo)
rhizome mcp plugin install https://github.com/unity-edu/rhizome-kanban-mcp.git
rhizome mcp call kanban.add_card --arg title="Draft release notes"

目录布局

rhizome-kanban-mcp/
├── README.md
├── LICENSE
├── rhizome-mcp.json        # tells Rhizome how to launch the server
├── bin/kanban-mcp          # thin launcher (stdio JSON-RPC)
├── kanban_mcp/             # Python package with server + helpers
└── docs/
    └── API.md              # tool contracts & payload examples

MCP服务器是无状态的。它读/写 .rhizome/kanban/board.json 在调用存储库中。钩子可执行文件(如果存在)位于 .rhizome/kanban/hooks.d/.

需求

  • Python 3.9+
  • 无第三方依赖;仅使用标准库模块。

发展

python -m compileall kanban_mcp bin/kanban-mcp
pytest            # (optional) if you add tests

在提交PR之前运行lint/test套件。该项目使用MIT许可证。