Prism Guard-MCP 服务器
使用说明
-
项目概览
- Prism 中的 Guard-MCP 服务器实现了一个基于 MCP 的后端服务，核心职责是以标准化方式向 LLM 客户端提供上下文信息和功能。它托管工具、资源以及提示模板，并通过 MCP 规范的接口与客户端通信，处理请求、返回响应或通知。
-
主要功能点
- MCP 服务端实现：实现了 MCP 的工具注册、调用与上下文传输等核心能力，支持通过 HTTP 传输与 JSON-RPC 风格交互。
- 工具注册与执行：实现了 send_intent 等工具，客户端可以通过 MCP 调用工具，服务器会转发并返回执行结果。
- Prompts 与治理模板：提供管理侧提示模板加载，方便统一渲染和使用。
- 身份认证与请求路由：基于请求头进行认证并将必要头信息转发给下游管理端或策略引擎。
- 健康与可观测性：包含健康路由与可观测性相关功能，便于运维监控。
-
安装与运行步骤
- 准备环境
- 需要 Python 运行环境以及依赖库（如 fastmcp、http 客户端库等）。请按照仓库的依赖管理方式安装。
- 启动 MCP 服务器
- 在仓库根目录或适当的工作目录执行以下命令启动 MCP 服务器（实际命令以实现入口为准）：
- 以管理平面路径运行的入口：启动管理平面中的 MCP 服务器子模块，默认通过 HTTP 传输在端口 3001 启动，路径 /mcp。
- 常用环境变量（示例）：
- MCP_SERVER_PORT: 3001
- MCP_SERVER_HOST: 0.0.0.0
- MCP_SERVER_TRANSPORT: http
- MCP_SERVER_PATH: /mcp
- 在仓库根目录或适当的工作目录执行以下命令启动 MCP 服务器（实际命令以实现入口为准）：
- 客户端接入
- 客户端需要指向上述 MCP 服务器地址，发送符合 MCP 的请求格式即可。GuardMCPClient（管理端客户端）提供了 list_tools、call_tool 等接口，用于与 MCP 服务器交互。
- 准备环境
-
服务器配置（客户端使用说明，不包含具体代码）
- server name: prism-guard-mcp-server
- command: python
- args: ["-m", "management_plane.mcp_server"] 说明：上述入口会启动 MCP 服务器进程。请确保工作目录正确、所需依赖安装完毕。
- 额外环境变量（可选）：
- MCP_SERVER_PORT: 3001
- MCP_SERVER_HOST: 0.0.0.0
- MCP_SERVER_TRANSPORT: http
- MCP_SERVER_PATH: /mcp
- 其他依赖的管理平面地址或密钥等，请按实际部署配置。
-
基本使用方法
- 连接与探索
- 使用 GuardMCPClient 等客户端连接到服务器地址（例如 http://localhost:3001/mcp）。
- 调用 list_tools 或等效方法获取服务器暴露的工具列表，确认 send_intent 等工具已注册。
- 调用工具
- 通过 MCP 调用工具，例如发送一个 intent，请求将被服务器解析、路由到管理平面进行决策并返回结果。
- 处理响应中的 decision、参数修改（如 MODIFY 时的修改参数）等信息。
- 监控与运维
- 使用健康端点查看服务器健康状态，结合服务器日志进行排错。
- 连接与探索