Prism MCP 服务器（基于 Model Context Protocol 的后端服务）

使用说明

• 项目简介
  • Prism MCP 服务器是 Prism 生态中的后端组件之一，基于 Model Context Protocol (MCP) 构建，核心职责是向 LLM 客户端提供上下文信息和功能。它托管并管理资源（Resources）、注册并执行工具（Tools）、定义并渲染提示模板（Prompts），并通过 JSON-RPC 与客户端通信。服务器实现了会话管理、能力声明，以及对多传输协议的理论支持，旨在为 LLM 应用提供安全、可扩展的上下文服务框架。
• 主要功能点
  • MCP 服务器核心：实现基于 MCP 的后端服务，处理 MCP 请求/响应，管理资源、工具和 Prompts。
  • 工具与命令注册：提供工具注册与调用（如 send_intent），支持通过工具执行外部功能。
  • 会话与审计：对会话进行追踪、状态、以及策略执行的证据记录，便于审计与回放。
  • 安全与鉴权：在 MCP 请求中对租户/用户进行鉴权，支持 x-tenant-id、x-user-id 等头信息传递。
  • 兼容性设计：以 MCP 标准为核心，与 Guard/MCP 客户端等集成，能够在多种传输通道间工作（理论层面的多传输支持）。
• 安装步骤
  • 克隆或获取代码库中的 MCP 服务器相关模块（management_plane/mcp_server）及其依赖。
  • 安装 Python 依赖，确保 FastMCP 及相关包可用（服务器端语言以 Python 实现，使用 FastMCP 库）。
  • 产线部署时可通过环境变量配置启动参数（如传输方式、监听地址、路径等）。
• 服务器配置（MCP 客户端所需信息须由你方在客户端 JSON 配置中填写，下面给出可参考的服务器启动配置信息）
  • 服务器名称：guard-mcp-server（来自代码中的 MCP 实例名）
  • 启动命令与参数（示例，实际可按你的部署环境调整）
    • 命令：python
    • 参数：-m management_plane.mcp_server
  • 说明：客户端需要知道服务器启动命令及路径，以便以 MCP 客户端连接到服务器的 /mcp 端点（默认端口 3001，路径 /mcp）。你可以通过环境变量覆盖端口、路径、传输方式等。
• 基本使用方法
  • 启动服务器：以管理端口和路径运行上面的启动命令，确保工具初始化完成后再对外提供服务。
  • 与客户端对接：MCP 客户端（如 guard_mcp_client）通过 JSON-RPC 调用服务器实现资源查询、工具调用及 Prompts 获取等能力。
  • 运行后可通过管理端的工具、Prompts、资源等接口进行注册与管理，确保 send_intent 等核心工具注册完成后再开启对外服务。