PMAT-MCP-Agent-Toolkit

关键词

资源管理工具执行Prompt 模板JSON-RPCRust 服务端

使用说明

  • 项目简介 PMAT-MCP-Agent-Toolkit 是一套基于 MCP 的后端服务器实现，聚焦向大型语言模型客户端提供规范化的“上下文服务”：托管资源、注册并执行工具、定义并渲染 Prompt 模板。服务器通过 JSON-RPC 与客户端通信，具备会话管理、能力声明，以及对多种传输协议的支持，便于在多样化的工作流中集成上下文信息和外部能力。

  • 主要功能点

    • 资源管理：在 MCP 服务器端托管和访问数据资源，供 LLM 客户端查询和读取。
    • 工具注册与执行：注册外部工具，允许 LLM 客户端发起工具调用并获取执行结果。
    • Prompt 模板管理与渲染：定义、储存并渲染提示模板，支持自定义的交互模式。
    • JSON-RPC 协议实现：标准化的请求/响应格式，支持请求ID匹配与错误处理。
    • 会话与能力声明：对客户端会话、能力（资源、工具、Prompts 等）进行声明与协商。
    • 多传输协议支持：默认 STDIO，未来可切换到 SSE、WebSocket 等传输方式，方便嵌入式、服务端和浏览器客户端的接入。

  • 安装步骤

    1. 安装 Rust 与 Cargo（官方安装指南即可）。
    2. 将代码克隆到本地后，在仓库根目录执行构建与安装：
      • cargo build --release
      • 或直接 cargo install --path .
    3. 编译完成后，可以直接启动 MCP 服务器，例如通过 PMAT 提供的命令入口启动。

  • 服务器配置（供 MCP 客户端使用的 JSON 配置，描述服务器名称、启动命令及参数等） { "server_name": "PMAT-MCP-Server", "command": "pmat", "args": ["mcp", "--transport", "stdio"], "description": "PMAT MCP 服务器入口，使用标准输入输出作为传输通道，提供 MCP 的资源、工具与 prompts 服务。" } 配置说明：

    • server_name: 服务器在客户端侧的标识名称，请保持唯一性以便区分多服务器实例。
    • command: 启动服务器的可执行文件名，在本仓库中对应 PMAT 的主命令入口。
    • args: 启动参数，示例中指定 mcp 子命令与传输模式。客户端读取该信息以建立连接。
    • description: 对服务器的简要说明，帮助运维与调试。

  • 基本使用方法

    1. 启动服务器：在支持的环境中执行 PMAT 的 MCP 启动入口，选择合适的传输通道（如 STDIO、SSE、WebSocket）。
    2. 客户端连接：MCP 客户端使用 JSON-RPC 通过选定的传输通道向服务器发送读取资源、调用工具、获取 Prompt 等请求。
    3. 资源、工具、Prompts 的注册与渲染：开发者在服务器端注册所需的资源、工具与 Prompt 模板，客户端可通过标准化的接口进行访问与执行。
    4. 会话与能力协商：客户端在初始化阶段声明能力，服务器返回可用能力清单，双方达成共享的通信能力。
    5. 安全与扩展：服务器端实现会话管理和能力声明，易于接入更高级的鉴权、沙箱和扩展插件。

服务器信息

访问项目