使用说明
根茎看板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许可证。