Prompt Optimizer 的 MCP 服务器模式是什么

MCP 服务器模式是开源提示词优化工具 Prompt Optimizer（GitHub 约 3.5 万 Star，2026 年 9 月，官方 README）提供的一种部署形态：把提示词优化能力以 Model Context Protocol 工具的形式暴露出来，Cursor、Claude Code、Claude Desktop 这类 MCP 客户端可以直接调用，不必切到网页或扩展里操作。MCP 是一个开放协议，作用是让 AI 应用以统一方式调用外部工具和数据源。Prompt Optimizer 的 MCP 模式对外提供三个工具——optimize-user-prompt（优化用户提示词）、optimize-system-prompt（优化系统提示词）、iterate-prompt（对成熟提示词做定向迭代优化），工具清单出自官方 MCP 部署指南（docs/user/mcp-server.md）。它解决的具体问题：写代码时要顺手改 agent 角色定义或工具描述的场景，以前要复制粘贴到浏览器里改，现在编码代理自己就能调。

为什么在编码工具里优化提示词

写代码时最难写的经常是代码之外的那几段话：agent 的角色定义、system prompt、Function Calling 的工具描述。这些内容决定模型行为，却只能靠手写和猜。MCP 模式把优化能力放进编码工具的上下文里——代理在实现 agent 时可以直接调用 optimize-system-prompt 改角色定义，迭代完不满意再调 iterate-prompt 定向修。浏览器形态做同样的事，要复制粘贴加来回切窗口，优化一次的成本高到没人愿意多试几轮。官方把 MCP 支持列在核心特性里，与 Claude Desktop 等 MCP 兼容应用集成，Docker 部署时 MCP 服务器自动启动。

部署：Docker 一条命令，MCP 自动启动

官方 MCP 指南推荐的部署方式是 Docker：Web 界面和 MCP 服务器同时启动，MCP 挂在同一端口的 /mcp 路径下。命令出自官方 MCP 部署指南：

docker run -d -p 8081:80 \
  -e VITE_OPENAI_API_KEY=your-openai-key \
  -e MCP_DEFAULT_MODEL_PROVIDER=openai \
  --name prompt-optimizer \
  linshen/prompt-optimizer

# Web 界面：http://localhost:8081
# MCP 服务器：http://localhost:8081/mcp

MCP 专属环境变量（出自官方 MCP 指南）：MCP_DEFAULT_MODEL_PROVIDER 是首选模型提供商，配置了多个密钥时用它指定，可选值有 openai、gemini、anthropic、deepseek、grok、siliconflow、zhipu、dashscope、openrouter、modelscope、custom 共 11 个；MCP_LOG_LEVEL 控制日志级别（debug、info、warn、error）；MCP_HTTP_PORT 默认 3000，Docker 部署无需设置；MCP_DEFAULT_LANGUAGE 默认 zh。至少要配一个 API 密钥，否则启动会报 No enabled models found。

开发者本地部署这条路官方指南也有写，但明确注明仅适用于开发调试：克隆仓库、pnpm install、复制 env.local.example 为 .env.local 配好密钥，然后 pnpm mcp:dev，服务器起在 http://localhost:3000/mcp。部署完想先验证，用官方 MCP Inspector：另开终端跑 npx @modelcontextprotocol/inspector，传输方式选 Streamable HTTP，填入服务器 URL 点 Connect，能列出上面三个工具就通了。

排障也有现成路径，官方指南的故障排查部分覆盖了三类高频问题：端口被占用报 EADDRINUSE，用 netstat 查占用进程，或改 MCP_HTTP_PORT 换端口再起；密钥无效报 No enabled models found，回环境变量确认至少一个有效 Key；连接行为异常时，把 MCP_LOG_LEVEL 调到 debug 看详细日志，Claude Desktop 连不上则按指南给出的顺序查四件事——服务器是否在运行、URL 是否正确、防火墙设置、客户端日志。

接入 Cursor 与 Claude Code

Prompt Optimizer 的 MCP 服务器走 HTTP Streamable 传输（官方 MCP 指南），任何兼容 MCP 的客户端拿到这个 URL 就能接。官方指南给出完整配置样例的是 Claude Desktop：在配置目录（Windows 是 %APPDATA%\Claude\services，macOS 是 ~/Library/Application Support/Claude/services，Linux 是 ~/.config/Claude/services）创建或编辑 services.json：

{
  "services": [
    {
      "name": "Prompt Optimizer",
      "url": "http://localhost:8081/mcp"
    }
  ]
}

Cursor 和 Claude Code 的接入是同一件事的变体：在各自的 MCP 配置里添加一个 HTTP 类型的服务器，URL 指向 http://localhost:8081/mcp，具体字段名以两家当前版本的官方文档为准，照抄别人的旧配置容易踩字段格式漂移的坑。有一个已知的版本坑值得检查：官方 MCP 指南记载，Docker 启用 ACCESS_PASSWORD 后，v1.4.0 之前的版本 MCP 连接会返回 401（Nginx 的 Basic 认证覆盖了 /mcp 路由），v1.4.0 起已修复，/mcp 路由绕过 Basic 认证而 Web 界面仍受密码保护——报 401 先确认镜像版本。部署本身的更多方式（在线版、扩展、桌面应用）见安装指南。

三个工具的典型用法

optimize-user-prompt、optimize-system-prompt、iterate-prompt 分别对应用户提示词、系统提示词、存量提示词迭代三类需求，工具描述出自官方指南。以下场景是基于工具语义的典型用法，具体调用行为以实际运行为准：

  • 优化 agent 角色定义：写 agent 框架的角色提示词时调 optimize-system-prompt，让它补齐输出结构和约束。Claude Code 用户可以把 CLAUDE.md 里效果不好的段落抽出来迭代后再放回去，CLAUDE.md 本身的写法见 CLAUDE.md 指南。
  • 补工具描述：给 Function Calling 写工具描述和参数说明时，把草稿丢给 optimize-user-prompt，让它把触发条件和参数语义写清楚。
  • 存量提示词小步调优：已经上线、只差临门一脚的提示词用 iterate-prompt，官方对它的定位是”基于特定需求迭代改进成熟的提示词”，适合带着明确缺点去做定向修改。

MCP 工具和 Claude Code 的 skills 是互补关系：skills 解决领域知识怎么装进代理，MCP 工具解决外部能力怎么接进代理，两者的取舍在 Claude Code skills 一篇里展开过。

MCP 模式与浏览器扩展模式对比

维度MCP 服务器模式Chrome 扩展 / Web 版
调用方Cursor、Claude Code、Claude Desktop 等 MCP 客户端人，在浏览器里操作
部署Docker（MCP 自动启动）或开发者本地 pnpm mcp:dev零部署或商店安装一次
交互方式代理按需调用三个优化工具图形界面：优化、测试、评估、收藏全流程
适合节奏编码中批量、自动化地改提示词写作聊天场景，人工精细调优
依赖一个模型 API Key 加 Docker浏览器加 API Key

两条路不互斥：Docker 部署里它们是同一个容器的两个入口，Web 界面在根路径，MCP 服务器在 /mcp，共用同一套模型配置。优化出来的提示词怎么管理、怎么沉淀成团队资产，方法论在提示词优化方法一篇。

常见问题

prompt mcp 是什么？

prompt mcp 通常指把提示词优化能力通过 MCP 协议暴露给 AI 应用的服务端实现，Prompt Optimizer 是这类实现里 Star 最高的开源项目之一（约 3.5 万，2026 年 9 月）。它的 MCP 服务器提供 optimize-user-prompt、optimize-system-prompt、iterate-prompt 三个工具，Docker 部署时自动启动，地址是 http://ip:端口/mcp，协议为 HTTP Streamable（官方 MCP 指南）。

mcp server 提示词优化怎么接入 Cursor？

先用 Docker 起服务：docker run -d -p 8081:80 并带上 VITE_OPENAI_API_KEY 和 MCP_DEFAULT_MODEL_PROVIDER 环境变量，然后把 http://localhost:8081/mcp 作为 HTTP Streamable 类型的 MCP 服务器加进 Cursor 的 MCP 配置。官方文档验证过的配置样例是 Claude Desktop 的 services.json 结构，Cursor 的字段名以 Cursor 官方文档为准。连接报 401 时检查镜像是否在 v1.4.0 以上。

cursor mcp 推荐里值得加提示词优化器吗？

如果你的工作流高频写 system prompt、agent 角色定义或工具描述，值得加：它是约 3.5 万 Star 的开源项目，MCP 模式提供三个专门的优化工具，调用发生在编辑器内，不打断编码节奏。如果只是偶尔改几句提示词，Chrome 扩展更轻，不必占一个 MCP 连接位。两者的完整对比见上文表格。