Relay-MCP 服务器实现

关键词

资源管理JSON-RPC代理生命周期UNIX 套接字PTY 注入

使用说明（Markdown 摘要）

  • 项目简介

    • Relay-MCP 服务端实现是一套完整的 MCP 服务器方案，核心通过 relay-pty 的 UNIX 套接字服务器实现 MCP 请求的处理、状态回传与代理人生命周期管理，支持注入请求、状态查询、关机、以及后续扩展的工具/资源/提示模板等能力。
    • 同时包含与 MCP 客户端集成所需的协议定义、数据结构、队列化注入、连续性管理、以及对多种代理客户端的测试用例，便于在本地或在 CI 中进行端到端验证。

  • 主要功能点

    • MCP 核心请求/响应处理：接收 Inject、Status、Shutdown 等 MCP 请求，返回 InjectResult、Status、Backpressure、ShutdownAck 等响应。
    • 资源与任务调度：通过队列（Queue）对注入请求进行排队、去重、背压控制，并对注入结果进行广播。
    • 代理生命周期管理：支持 spawn、release、launch/terminate 的代理控制，能跨进程协作地创建并清理工作代理。
    • 断言式状态与连续性：提供持续的状态查询、连续性（continuity）支撑，以及对任务结果的持续性保存与恢复。
    • 事件总线与日志：通过广播通道将代理响应、注入状态等事件广播给订阅方，便于监控、记录和调试。
    • 多种输入输出与传输：工作在 UNIX 套接字上，具备对 PTY 的处理能力，与 LLM 客户端通过 MCP 的标准化上下文服务进行交互，易于扩展到 Stdio、SSE、WebSocket 等传输。

  • 安装与运行

    • 先决条件：具备相应的编译环境（Rust/Rust 工具链）与 MCP 客户端的集成需求。
    • 构建服务器核心（relay-pty）：
      • 在 relay-pty 目录下构建 main.rs 所在的服务端二进制。
      • 运行后服务器将监听一个 UNIX 套接字，接收 MCP 请求与注入命令等。
    • 与 MCP 客户端对接：
      • MCP 客户端通过 JSON-RPC 风格的请求发送到 MCP 服务器（本实现通过本地 UNIX 套接字通信）。
      • 客户端需要配置服务器启动命令及参数（见下方“服务器配置”示例）。
    • 运行测试与验证：
      • 仓库内包含大量 MCP 相关的集成测试脚本，可用于在本地验证连接、 spawning、消息传递、投票、连续性等场景。

  • 服务器配置（MCP 客户端必需信息）

    • MCP 客户端在连接 MCP 服务器时需要提供服务器启动命令及参数，用以启动 MCP 服务端。示例 JSON 配置（仅作为客户端配置示范，实际要以 MCP 客户端的实现格式为准）： { "server": "relay-pty", "command": "relay-pty", "args": [ "--name", "ClaudeAgent-01", "--socket", "/tmp/relay/ClaudeAgent-01.sock", "claude" ], "comment": "该配置用于让 MCP 客户端在本地启动 relay-pty MCP 服务端进程，参数对接到服务器的命令行参数。" }
    • 说明：
      • server 字段为 MCP 服务器标识（此处为 relay-pty）。
      • command 为实际要执行的服务端可执行程序名。
      • args 为传给服务器端的命令行参数，包含服务端识别的名称、套接字路径、以及默认代理 CLI 等信息。
      • 客户端通常不需要暴露内部实现细节给最终用户，但用于集成时应确保服务器命令和工作参数正确无误。

  • 基本使用方法

    • 启动 MCP 服务器端（Relay-MCP 服务端）：
      • 依赖本仓库中 relay-pty 的实现，参考仓库内的 README/MCP 部分启动脚本和示例配置。
    • 连接 MCP 客户端并执行资源/工具/提示模板相关操作：
      • MCP 客户端通过统一协议发起注入请求、查询状态、发送/接收工具调用结果等。
      • 服务端负责维护会话、能力声明、以及对不同代理的生命周期管理。
    • 常见工作流程：
      • 服务器启动后，客户端通过请求注入（Inject）将任务分发给代理，代理通过 Spawn/Release 管理生命周期。
      • 客户端可通过 Status、Backpressure 等通知获得队列与系统状态。
      • 服务器广播注入结果（Injected、Injecting、Delivered、Failed 等状态）给所有感兴趣的订阅者。
    • 调试与扩展：
      • 仓库中提供了大量 MCP 测试用例与工具，便于快速验证。
      • 如需扩展资源、工具、或 prompts，需要在服务器实现中注册相应资源/工具/模板，并在 MCP 客户端进行对接。

  • 关键词

    • MCP、资源管理、工具注册、JSON-RPC、UNIX 套接字、PTY 注入、代理生命周期、事件广播

  • 分类

    • 分类ID 6（AI 与计算）

服务器信息

访问项目