chenyinrusi/dsh-kanban-mcp

Name: chenyinrusi/dsh-kanban-mcp
Author: chenyinrusi

插件Plugin ⭐ 2 MIT cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh cat_label.kanbancat_label.kanban cat_label.mcp-servercat_label.mcp-server

Filesystem-driven four-lane kanban board (todo / doing / blocked / done) as a read-only MCP server and Python API. Works with DeepSeek Harness and any MCP client.

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

基于文件系统的四车道看板（待办/进行中/阻塞/已完成），以只读MCP服务器和Python API形式提供。看板即Markdown卡片目录树，可Git diff、无需数据库。适合需要持久化、可审计任务状态的智能体工作流。注意：MCP端仅支持读取，写入需通过Python API。

A filesystem-driven four-lane kanban board (todo/doing/blocked/done) exposed as a read-only MCP server and Python API. Cards are markdown files in a directory tree, making the board git-diffable, restart-proof, and database-free. Use it when agents need persistent, inspectable task tracking. Note: MCP tools are read-only; writes require the Python API.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-kanban-mcp】【https://github.com/chenyinrusi/dsh-kanban-mcp】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:chenyinrusi/dsh-kanban-mcp

把 chenyinrusi/dsh-kanban-mcp 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.6 KB · 缓存于 2026-08-27 05:42:36 · 2.6 KB

dsh-kanban-mcp

Filesystem-driven four-lane kanban board (todo / doing / blocked / done) exposed as a read-only MCP server and a Python API. Works with DeepSeek Harness and any MCP client.

A kanban board is just a directory tree of markdown cards:

<base_dir>/YYYY/YYYY-MM/YYYY-MM-DD/{todo,doing,blocked,done}/YYYYMMDD-HHMMSS__agent__slug__status.md

That design is the whole point: the board survives restarts, is diffable in git, needs no database, and can be inspected by any file tool. This package manages those files and exposes the board to agents over MCP.

Install

pip install "dsh-kanban-mcp"          # Python API
pip install "dsh-kanban-mcp[mcp]"     # + MCP server (fastmcp)

Requires Python 3.10+.

Run the MCP server

python -m kanban_mcp          # stdio transport
# or: kanban-mcp

Register it in DeepSeek Harness (MCP settings — the built-in MCP client) or any MCP client. The tools take an optional base_dir argument (default .agent/kanban) so one server can point at any board.

Tools (read-only)

Tool	Description
`kanban_board`	Full four-lane board with card details (agent, work_item, purpose, status, outcome, priority, timestamps)
`kanban_status`	Per-lane card counts + total
`kanban_doing`	Cards currently in progress
`kanban_blocked`	Blocked cards
`kanban_done_today`	Cards completed today

All tools are read-only. Card creation / update / movement is available through the KanbanManager Python API (see below); write tools are planned but not yet exposed over MCP.

Python API

from kanban_mcp import KanbanManager, LaneStatus

kanban = KanbanManager(base_dir=".agent/kanban")

card = kanban.create_doing_card(
    agent="coder",
    work_item="build-api",
    purpose="Build the REST API endpoint",
)
kanban.update_card(card, outcome="GET /users implemented")
kanban.move_to_done("coder", "build-api", "API endpoint complete")

board = kanban.get_board()      # full board
stats = kanban.stats()          # per-lane counts
blocked = kanban.get_blocked_cards()

Writes go through an atomic temp-file + os.replace, so a concurrent reader never sees a half-written card.

Why files instead of a database

Git-diffable — card changes are reviewable like code.
Survives restarts — no daemon, no lock, no migration.
Inspectable — any file tool can read a card directly.
Portable — cp -r the directory and you have a new board.

Development

pip install -e ".[dev]"
pytest

License

渲染基于仓库 chenyinrusi/dsh-kanban-mcp 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install