Agent Kanban MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个以 MCP（Model Context Protocol）为基础的后端服务器，面向 humans 与 AI Agents 提供 Kanban 风格的项目管理能力。核心功能包括资源（Projects/Tasks/Stages/Comments 等）的托管、工具调用以执行外部任务，以及为 AI 客户端提供基于模板的 Prompt 与计划能力。MCP 服务器通过 JSON-RPC 风格的消息与客户端交互，并可在多种传输方式下工作（如标准输入输出流、WebSocket、Server-Sent 事件等）。

• 主要功能点

  • MCP 服务端实现：实现工具列表、工具调用、计划/模板生成等 MCP 端能力，向 AI 客户端暴露可调用的工具（如 create_project、get_projects、plan_project 等）。
  • 资源管理：支持项目、阶段、任务、子任务、评论等多种资源的增删改查及关系管理。
  • 数据存储：使用 SQLite 数据库作为默认存储，提供简单的持久化能力用于示例与测试。
  • Agent 与 Human 分离认证：提供 Agent 的 API Key 认证和 Human 的基于用户名/密码的认证逻辑，支持在 MCP 场景下对不同实体进行授权。
  • MCP 客户端示例：包含演示脚本 demo_mcp_agent.py，展示 AI 助手如何通过 MCP 调用工具实现从计划到执行的工作流；以及示例客户端 example_agent_client.py，帮助理解如何通过 API 与系统交互。

• 安装步骤

  • 安装依赖：确保 Python 3.9+ 环境；通过 pip 安装所需依赖（仓库中提供的需求文件可用于安装 MCP 相关依赖）。
  • 安装 MCP 依赖（如未安装 MCP 库时）：pip install mcp
  • 安装并配置数据库：仓库使用 SQLite 默认数据库，可以通过初始化脚本或应用启动自动创建所需表结构。
  • 运行 MCP 服务器：在可运行的环境中执行 mcp_server.py（前提是已安装 MCP 库并满足依赖）。

• 服务器配置（MCP 客户端使用的启动配置信息，json 格式）

  • server name: "AgentKanbanMCP"
  • command: "python"
  • args: ["mcp_server.py"] 说明：该配置用于 MCP 客户端在启动连接时，指明服务器进程的执行命令与参数。MCP 客户端不需要直接包含代码；仅需知道如何启动服务器以建立通信通道。

• 基本使用方法

  • 启动核心应用：先启动主应用（非 MCP）以便提供 REST UI/API 及数据存储（可选），再启动 MCP 服务器以便 AI 助手通过 MCP 与 Kanban 系统协作。
  • 启动 MCP 服务：运行 mcp_server.py（前提是安装了 MCP 依赖）。
  • 连接 AI 客户端：使用客户端（如 Claude、ChatGPT 等）通过 MCP 配置连接到服务器，使用提供的工具（如 plan_project、create_project、get_project_details 等）进行协同计划与执行。
  • 演示与测试：可使用 demo_mcp_agent.py 作为对照示例，查看 AI 助手如何通过 MCP 调用工具创建和管理项目；也可使用 example_agent_client.py 进行 API 级别的交互示例。

• 备注

  • MCP 实现是本仓库中的一个独立模块，需安装并导入 mcp 库方可运行。
  • 若环境中未安装 MCP 库，程序将提示并给出安装指引。