vscode kanbn MCP

VSCode Kanbn MCP

概述

MCP确保严格遵守kanbn格式规范，处理：

• 用于板选项和任务元数据的YAML frontmatter
• 索引和任务文件的正确标记结构
• 根据预定义类别进行标签验证
• 开始/完成列的自动日期处理

特性

• 板初始化：使用可定制的列和选项创建新的kanbn板。
• 任务管理：添加、更新、移动和删除具有完整元数据支持的任务。
• 批量操作：在一次呼叫中添加多个任务。
• 标签验证：根据预定义的工作类型、域、优先级和工作量类别验证标签。
• 列自动行为：自动设置 started/completed 将任务移动到配置列的日期。
• 格式合规性：确保所有生成的文件与kanbn工具兼容。
• MCP协议：使用FastMCP正确实现MCP服务器，以实现AI代理集成。

作为MCP服务器运行

该模块提供了一个可以通过stdio传输运行的正确MCP服务器：

# Run the server directly
python -m mcps.vscode_kanbn_mcp.server

# Or from the project root
cd /path/to/adhd_framework
python -m mcps.vscode_kanbn_mcp.server

MCP客户端配置

对于VS Code或其他MCP客户端，请在MCP配置中添加：

{
  "mcpServers": {
    "kanbn": {
      "command": "python",
      "args": ["-m", "mcps.vscode_kanbn_mcp.server"],
      "cwd": "/path/to/adhd_framework"
    }
  }
}

作为图书馆使用

from mcps.vscode_kanbn_mcp import KanbnMCP, get_kanbn_mcp

# Initialize MCP for a workspace
mcp = get_kanbn_mcp(workspace_root="/path/to/project")

# Create a new board
mcp.init_board(
    name="My Project",
    description="Project planning board",
    columns=["Backlog", "In Progress", "Review", "Done", "Archive"]
)

# Add a task
mcp.add_task(
    name="Implement authentication",
    description="Add OAuth2 authentication flow",
    column="Backlog",
    tags=["feature", "security", "Large"],
    subtasks=["Research OAuth providers", "Implement flow", "Add tests"]
)

# Move task to In Progress
mcp.move_task("implement-authentication", "In Progress")

# Get board status
status = mcp.get_board_status()
print(status["columns"])  # Shows all columns with task counts

# Update task progress
mcp.update_task("implement-authentication", progress=0.5)

# Batch add tasks
mcp.batch_add_tasks([
    {"name": "Write docs", "tags": ["documentation", "Small"]},
    {"name": "Fix bug #123", "column": "In Progress", "tags": ["bug", "Tiny"]},
])

模块结构

vscode_kanbn_mcp/
├── __init__.py                      # Package exports
├── constants.py                     # Tag sets and default options
├── helpers.py                       # Utility functions (kebab-case, YAML parsing)
├── models.py                        # KanbnBoard and KanbnTask classes
├── kanbn_mcp.py                     # Main MCP class (library API)
├── server.py                        # FastMCP server entry point
├── vscode_kanbn_mcp.instructions.md # AI agent instructions
├── init.yaml                        # ADHD module config
├── .config_template                 # Config template
└── README.md                        # This file

MCP工具参考

服务器通过MCP协议公开这些工具：

图书馆API参考

KanbnMCP

有效标签

依赖项

• mcp[cli]>=1.9.0 -支持CLI的MCP Python SDK

另见

• kanbn CLI文档
• vscode kanbn扩展
• MCP Python SDK
• 指令核心（将指令同步到 .github/)