Vibe Kanban MCP 任务服务器

关键词

模型上下文服务任务编排后端JSON-RPC 接口上下文与工具暴露自动化协作

使用说明（Markdown）

  • 项目简介

    • 该仓库实现了一个 MCP 服务器，专门为 Vibe Kanban 生态中的任务/工作流提供结构化上下文、资源信息与工具执行能力。服务器通过 MCP 框架与客户端通信，处理 MCP 请求、生成响应，并向客户端提供可执行的工具入口。

  • 主要功能点

    • MCP 核心能力：实现 MCP 服务器端的请求处理、响应构造与 ServerInfo 提供能力声明，支持 ToolRouter 注册的工具入口，以及通过 JSON-RPC 风格的通信与客户端交互。
    • 资源与数据访问：公开与任务、项目、仓库、任务尝试等相关的数据查询与操作接口，便于 LLM 客户端按需获取上下文与执行结果。
    • 工具路由与渲染：通过 rmcp 提供的工具路由，暴露诸如获取上下文、创建任务、列出项目/仓库、获取仓库详情、更新仓库脚本等工具，LLM 可调用这些工具完成复杂工作流。
    • 服务器信息与能力声明：实现 get_info-like 的服务器信息，声明协议版本、能力集与服务器元数据，便于客户端在对话前知悉能力范围。
    • 多传输/扩展能力：设计稿中包含对工具的注册、上下文获取等接口，具备扩展为其他传输通道的潜力（如 SSE、WebSocket 等，当前实现以标准化工具调用为核心）。

  • 安装步骤

    • 安装 Rust 工具链，确保 cargo 可用。
    • 构建 MCP 任务服务器二进制：
      • cargo build --bin mcp_task_server
    • 运行 MCP 任务服务器（默认通过标准输入输出 stdio 与 MCP 客户端通信，需确保后端服务可访问底层 vibe-kanban API）：
      • 直接运行生成的二进制（如 target/debug/mcp_task_server 或 target/release/mcp_task_server），在需要时使用与后端后端服务的网络访问及鉴权配置。
    • 运行后端示例工作流的前提是后端 vibe-kanban 服务可访问（REST/API）并且 MCP 服务器能够通过基准 URL 获取上下文。

  • 服务器配置（MCP 客户端配置示例） 说明：MCP 客户端需要提供启动服务器的配置信息以建立连接。在此仓库中，MCP 服务器通过一个可执行二进制与后端 API 进行交互，客户端需要提供启动命令和参数来启动该 MCP 服务端。下面给出一个可用于 MCP 客户端的JSON配置示例描述，便于理解实际需要填写的字段（请用实际可执行路径替换示例路径）： { "server_name": "vibe-kanban-task-server", "command": "/path/to/mcp_task_server", "args": [ // 如果需要可在此添加启动参数，例如指定日志级别、后端地址等 // "--verbose", // "--base-url", "http://127.0.0.1:8080" ], "description": "Vibe Kanban MCP 任务服务器（客户端应在本地启动该命令以建立 MCP 服务）。" } 注：该配置用于 MCP 客户端启动时指定 MCP 服务器的执行信息。MCP 客户端本身并不需要理解后端内部实现细节，只需要知道服务器命令与参数即可启动与服务器建立连接。

  • 基本使用方法

    • 启动 MCP 任务服务器二进制后，LLM 客户端通过 MCP 协议发送请求（如获取上下文、列出任务、创建任务等）。
    • 调用结果以 JSON-RPC 格式返回，LLM 客户端可将返回的上下文信息用于对话生成、任务编排等。
    • 服务端负责会话状态与能力声明，确保在合适的场景下可以提供上下文和工具执行能力，帮助 LLM 构建更具上下文感知的交互。

服务器信息

访问项目