使用说明

• 项目简介

  • 该仓库实现了一个可运行的 MCP 服务器，用于通过 MCP 协议向远程语言模型代理提供对 Promptry 的功能访问。核心能力包括：管理 Prompt 版本、执行评测、检测漂移、运行安全模板，以及查询/执行相关工具等。服务器通过标准 MCP 服务暴露工具接口，便于 Claude Desktop、Cursor 等客户端对接。

• 主要功能点

  • Prompt 管理工具：列出现有提示、查看具体版本、比较差异、打标签等（prompt_list、prompt_show、prompt_diff、prompt_save、prompt_tag）。
  • 评测相关工具：列出评测套件、执行评测、带基线比较的评测、漂移检测等（list_suites、run_eval、check_drift、monitor_status）。
  • 安全模板工具：列出模板、执行安全审计、按类别筛选等（list_templates、run_safety_audit）。
  • 漂移与监控：通过 drift 检测评测分数的下降趋势并可通知。
  • MCP 兼容性：返回纯文本结果，便于 LLM 直接解析，且错误情况以文本返回。

• 安装与运行

  • 安装依赖后，通过命令启动 MCP 服务：promptry mcp
  • 该服务器是在本地进程中运行，提供一组工具接口供 MCP 客户端调用。MCP 客户端需通过配置指明启动服务器的命令和参数以建立连接。

• 服务器配置（MCP 客户端需要的配置） 为了让 MCP 客户端与该 MCP 服务器建立连接，客户端配置至少需要指定服务器名称、启动命令和参数。示例如下（描述性文本，不是代码块）： { "server_name": "promptry", "command": "promptry", "args": ["mcp"], "description": "Promptry MCP 服务端命令入口，启动后将暴露一组 MCP 工具供语言模型代理调用", "transport": "stdio" } 上述字段含义：

  • server_name：在客户端配置中对该 MCP 服务的标识名称（如 promptry）。
  • command：启动服务器的可执行命令，这里为 promptry。
  • args：启动服务器时的参数，这里传入 mcp 以启动 MCP 模块。
  • transport：传输方式，Promptry 通过标准输入/输出（stdio）与客户端通信（默认实现）。 注意：具体客户端实现可能在 UI/文档中进一步扩展字段，此处给出适用于多数 MCP 客户端最基本的连接信息。

• 基本使用方法

  • 启动：在具备环境的机器上执行命令启动 MCP 服务（promptry mcp）。
  • 客户端对接：MCP 客户端按提供的配置项连接到该 MCP 服务器，调用各类工具方法来管理提示、运行评测、查询模板等。
  • 交互风格：所有 MCP 工具返回的都是纯文本结果，便于 LLM 将结果直接作为推理材料进行下一步处理。
  • 运行环境：依赖本地 SQLite 存储和 Python 3.10+ 运行时，默认在本地文件系统中维护会话数据与历史。

• 注意事项

  • MCP 客户端与服务端的版本对齐与接口兼容性请参考项目的 MCP 相关文档和示例配置。
  • 为确保安全性，请在生产环境中对 MCP 调用进行鉴权和访问控制，避免未授权的工具执行。