wt-tools MCP 服务器实现

关键词

Model Context ProtocolJSON-RPC工作树资源Ralph 状态资源与工具暴露

使用说明（简要概览，适合快速上手）

  • 项目简介

    • 该仓库在 mcp-server 目录下实现了一个基于 FastMCP 的 MCP 服务器，其 wt_mcp_server.py 提供了资源和工具的实现，暴露给客户端通过 JSON-RPC 进行调用。

  • 主要功能点

    • 资源（Resources）
      • wt://worktrees：当前工作树集合信息
      • wt://ralph/status：Ralph 循环状态
      • wt://team：团队成员状态
    • 工具（Tools）
      • list_worktrees、get_ralph_status、get_worktree_tasks、get_activity、get_team_status、send_message、get_inbox、remember/recall 等一系列与本地系统状态、记忆、活动相关的操作
    • 交互协议
      • 通过 JSON-RPC 对外暴露方法，客户端可发送请求并获得结构化响应
    • 传输协议
      • 目前代码以 STDIO 为传输实现，理论上也可扩展为 SSE/WebSocket 等传输方式（快速原型与后续扩展点已在代码中留出接口）

  • 安装步骤

    • 确保环境：Python 3.10+、必要依赖（FastMCP 等）
    • 进入仓库并安装依赖
    • 直接运行服务器脚本：mcp-server/wt_mcp_server.py
      • 例如：python3 mcp-server/wt_mcp_server.py
    • 服务器启动后，客户端即可通过配置加载服务器并通过 JSON-RPC 与之通信

  • 服务器配置示例（供 MCP 客户端使用的配置格式） 说明：下面是一个简化的配置示例，展示客户端启动服务器所需的关键字段。JSON 仅用于配置描述，实际使用请按客户端要求的格式传递。

    { "server": { "name": "wt-tools-mcp", "command": "python3", "args": ["mcp-server/wt_mcp_server.py"], "transport": "stdio" // 指定传输方式，示例为 STDIO } // 说明：该配置用于 MCP 客户端启动并连接到服务器。客户端需要的具体字段可能因实现而异，本文给出准确且可执行的基础信息。 }

  • 基本使用方法

    • 启动服务器后，客户端通过 JSON-RPC 调用服务器暴露的资源与工具接口，获取工作树状态、Ralph 状态、团队活动等信息。
    • 客户端可将结果用于大语言模型的上下文注入、触发外部功能调用等，从而实现“给 LLM 提供上下文信息和能力”的 MCP 服务能力。
    • 如需扩展，可在 mcp-server/wt_mcp_server.py 中添加新的工具或资源，保持与 MCP 协议的对接。

服务器信息

访问项目