Agent Backlog MCP 服务器

关键词

LLM integrationKanban backlogSQLiteJSON-RPCUI leadership

使用说明

  • 项目简介
    • Agent Backlog MCP 服务器是一个完整的后端服务，基于 Model Context Protocol（MCP）实现，向 LLM 客户端提供上下文信息和功能能力。它通过 MCP 规范的 JSON-RPC 形式接收请求并返回结果，支持对 backlog 资源的读写、工具调用、以及提示渲染等能力。
    • 服务器具备本地存储与团队协同两种工作模式：在本地模式下使用本地 SQLite 数据库；在团队模式下通过远端 API 服务器进行数据交互。还集成 Kanban UI、朴素的 Leader 选举、以及对 UI 的单点协调等功能。
  • 主要功能点
    • MCP 核心能力：通过 MCP Server 注册工具（Tools）、提供读写资源（Items/Backlog）、管理工作流（Checklist、Dependencies、Comments）、以及对话中可调用的 Tools。
    • 数据与存储：使用 SQLite 数据库，提供本地存储（LocalStore）与远端存储（RemoteStore）的支持，包含版本控制与乐观锁（Version Conflict）处理。
    • 工具注册与执行：开发了多个工具集合（Item、Checklist、Comment、Dependencies），支持参数校验、版本控制、以及结果回传。
    • UI 与 Leader 机制：内置 Kanban UI 服务以及 UI Leader 选举，确保 UI 实例的高可用性与自动故障转移。
    • 运行模式：本地模式（直接操作本地数据库）与远程模式（通过 API 服务器进行数据访问），可通过配置切换。
    • 安全与运维：日志系统、健康与迁移工具、以及对不同场景的错误处理（如版本冲突、未找到资源等）设计完善。
  • 安装步骤
    • 克隆仓库并进入 MCP 服务目录，安装依赖。
    • 使用 Node.js 运行 MCP 服务器（无须安装额外依赖即可启动）。
    • 如需本地 UI，请确保 UI 启动依赖可用，MCP 与 UI 之间通过本地/远程接口交互。
  • 服务器配置（MCP 客户端需要的最小信息，JSON 格式表示）
    • server_name: 指定服务名称，例如 "agent-backlog"
    • command: 启动服务器的命令，例如 "node"
    • args: 启动参数数组，指向 MCP 服务器入口，例如 ["packages/mcp/src/server.js"]
    • transport: 传输机制，MCP 客户端常用为 "stdio"（服务器端使用 StdioServerTransport）
    • 其他说明：服务器内部会根据 CONFIG 自动加载本地/远程模式的配置，客户端通常只需要关心上述字段即可连接启动 伪示例（请按实际运行环境填写，客户端无需展示代码）: { "server_name": "agent-backlog", "command": "node", "args": ["packages/mcp/src/server.js"], "transport": "stdio" }
  • 基本使用方法
    • 启动 MCP 服务器：在支持 Node.js 的环境中直接运行入口脚本，服务器会初始化数据库、注册工具并启动 MCP 服务。
    • 与 MCP 客户端交互：客户端通过 JSON-RPC 调用已注册的工具（如 backlog_list、backlog_get、checklist_add 等），服务器返回标准的 JSON-RPC 响应或错误信息。
    • UI 与 Leader：服务器自动启动 UI 管理模块，并在单点 UI 领导模式下进行协调；遇到 UI 崩溃时会自动故障转移。
    • 维护与扩展：可通过注册新的工具模块扩展功能，当前实现包含 Item、Checklist、Comment、Dependencies 等工具集合。

服务器信息

访问项目