Pierre MCP 服务器端

关键词

模型上下文协议LLM 集成JSON-RPC资源管理工具调用

使用说明（Markdown 格式）

  • 项目简介

    • Pierre MCP 服务器端是一套面向 AI 助手的后端服务，按照 MCP 标准暴露资源、工具与提示模板，并通过 JSON-RPC 与客户端进行通信。它实现了资源管理、工具注册与执行、提示模板渲染，并与 A2A、OAuth2 等子系统协同工作，支持多传输协议与会话/权限管理，以提供安全、可扩展的上下文服务。

  • 主要功能点

    • MCP 核心协议支持：按照 JSON-RPC 2.0 规范处理请求与响应，提供对资源、工具、提示模板等的托管和访问能力。
    • 资源/工具/Prompt 管理：集中管理数据资源、外部工具接口以及可定制的提示模板，方便 LLM 调用和上下文渲染。
    • 连接与认证：包含 OAuth 2.0、A2A 等协议能力，支持多租户场景和安全认证。
    • LLM 集成：与多家 LLM 提供商的集成（SDK/适配器在工作区内实现），能够进行模型对话、流式响应和能力声明。
    • 多传输协议与会话管理：支持 Stdio、SSE、WebSocket 等传输，具备会话管理、能力声明和多协议互操作性。
    • 安全与扩展性：具备错误/权限模型、可插拔的提供者/工具模块、基于特性开关的编译配置，便于按需构建。
    • 客户端生态：与 Claude Desktop、Claude-like 客户端和自有 MCP 客户端通过标准化接口对接。

  • 安装步骤

      1. 克隆仓库并进入项目根目录。
      1. 根据需要选择服务器镜像与依赖特性进行构建，例如开启数据库或 SaaS 全量特性：
      • 构建桌面/本地客户端适用的最小化版本（示例，实际可选特性请以仓库文档为准）： cargo build --release --no-default-features --features "sqlite,server-mcp-stdio"
      • 构建 SaaS 全量部署版本： cargo build --release --no-default-features --features "postgresql,server-saas-full"
      1. 启动后端服务器 运行服务器二进制，例如 pierre-mcp_server，并监听默认端口（8081，具体端口以环境变量/配置为准）。
      1. （可选）启动前端、移动端等附加组件（如前端仪表盘、Expo 移动端等），按仓库提供的脚本/文档进行。

  • 服务器配置（面向 MCP 客户端，客户端需要的配置信息）

    • MCP 客户端需要连接到本服务器以进行请求/调用。示例客户端启动信息如下，描述仅作配置示例，实际客户端的使用可能通过 Claude Desktop、SDK 客户端等方式实现：
    • server_name: pierre-fitness
    • command: npx
    • args: ["-y", "pierre-mcp-client@next", "--server", "http://localhost:8081"]
    • 注释：这是客户端启动命令的典例，用于连接到 Pierre MCP Server。MCP 客户端端不需要在服务器端配置中体现，本文仅给出示例以帮助理解如何在客户端配置中指向本 MCP 服务器。服务器端运行端口通常为 8081（如无特殊配置，请保持默认端口），客户端通过该端点与 MCP 服务交互。

  • 基本使用方法

      1. 启动服务器后，客户端通过 MCP JSON-RPC 发送请求，如读取资源、调用工具、获取 Prompt 等，服务器返回标准化的 JSON-RPC 响应。
      1. 通过端口 8081 的 HTTP/WebSocket/SSE 等传输协议进行交互，确保租户、权限和会话上下文正确建立。
      1. 使用方可通过工具与资源的组合实现对 LLM 的上下文注入、工具执行以及提示渲染等能力。
      1. 如需调试或扩展，可以查看仓库中的核心模块（资源、工具、PROMPTS、A2A/OAuth、LLM 适配等实现），并结合 CI/CD 流水线进行本地验证。

  • 备注

    • 仓库的 Core、Intelligence、Providers、Formatters 等组件共同构成 MCP 服务器生态，实际部署时请参照仓库的构建配置、CI 脚本与文档说明。

服务器信息

访问项目