prompt-optimizer MCP协议集成快速指南：一条命令部署MCP服务器，接入Claude Desktop获得3个提示词优化工具

prompt-optimizer MCP协议集成快速指南一条命令部署MCP服务器接入Claude Desktop获得3个提示词优化工具【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer你多半干过这件事在 Claude Desktop 里写完一句提示词觉得太糙切到浏览器打开提示词优化工具粘贴、等待、复制回来再切回对话窗口。来回三次思路断了。prompt-optimizer 的 MCP 集成就是解决这一步的——把提示词优化能力装进 Claude Desktop优化时不用离开对话窗口。MCPModel Context Protocol是让 AI 应用调用外部工具的一种标准协议你可以理解成给 Claude Desktop 装的外设接口。全文按部署 → 接入 → 使用 → 排障走一遍Docker 用户全程只需要一条命令。 一条 Docker 命令部署 MCP 服务器Docker 镜像里同时包含 Web 界面和 MCP 服务器启动后两者都在docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY你的openai密钥 \ -e MCP_DEFAULT_MODEL_PROVIDERopenai \ --name prompt-optimizer \ linshen/prompt-optimizer # 拉取 Docker Hub 慢时把最后一行镜像换成国内镜像 # registry.cn-guangzhou.aliyuncs.com/prompt-optimizer/prompt-optimizer启动后记住两个地址Web 界面是http://localhost:8081MCP 端点是http://localhost:8081/mcp。需要自定义配置时用 Docker Compose骨架如下完整版见仓库 docker-compose.ymlservices: prompt-optimizer: image: linshen/prompt-optimizer:latest container_name: prompt-optimizer restart: unless-stopped ports: - 8081:80 environment: - VITE_OPENAI_API_KEY你的openai密钥 - MCP_DEFAULT_MODEL_PROVIDERopenai - MCP_LOG_LEVELinfo环境变量只需关心这几项更多选项见 env.local.example环境变量必填默认值作用VITE_OPENAI_API_KEY或任意一家 API 密钥✅—优化用的 LLM至少配一个VITE_CUSTOM_API_KEY/_BASE_URL/_MODEL❌—接 Ollama 等 OpenAI 兼容接口MCP_DEFAULT_MODEL_PROVIDER❌openai配了多家密钥时指定默认用谁MCP_LOG_LEVEL❌debug日志级别debug / info / warn / errorMCP_DEFAULT_LANGUAGE❌zh优化结果的默认语言zh / en⚙️ Claude Desktop 配置 MCP 三步验证 3 个工具第 1 步定位配置目录系统路径Windows%APPDATA%\Claude\servicesmacOS~/Library/Application Support/Claude/servicesLinux~/.config/Claude/services第 2 步写入services.json{ services: [ { name: Prompt Optimizer, url: http://localhost:8081/mcp } ] }本地开发部署端口 3000的用户把 URL 换成http://localhost:3000/mcp。第 3 步重启 Claude Desktop打开工具列表。同时看到optimize-user-prompt、optimize-system-prompt、iterate-prompt这 3 个名字接入就成功了。只看到名字但调用报错跳到下面的排障清单。️ 3 个工具怎么用各一个最小示例optimize-user-prompt优化对话级提示词用途把含糊的口语化请求扩写成目标明确、带约束的指令。最小调用只传promptoptimize-user-prompt({ prompt: 帮我看看这段代码 })优化前优化后帮我看看这段代码请审查以下代码片段从正确性、性能、可读性三个维度检查。每个问题给出所在行号、影响说明和修改后的代码按严重程度从高到低排列。optimize-system-prompt优化系统提示词用途把一句话的角色设定升级成带角色边界、行为规则和输出格式约束的完整系统提示词。optimize-system-prompt({ prompt: 你是一个客服 })优化前优化后你是一个客服你是某 SaaS 产品的客服专员只回答功能、计费与集成相关的问题。超出范围的请求引导用户走官方支持渠道。回答用编号列表结尾附一句确认用户下一步操作。不确定时直接说明禁止编造。iterate-prompt按具体不满迭代修改用途提示词已经能用但某处不达标。你带着具体毛病提它只改毛病处不动原有意图。iterate-prompt({ prompt: 现有提示词全文, requirements: 回答太长压缩到3条要点语气保持专业 })迭代前迭代后你是代码审查助手请给出详尽的审查意见输出动辄千字重点淹没你是代码审查助手。审查意见只输出3条要点最严重的问题、风险等级、修改建议。每条不超过两行不展开背景说明。 模板、本地模型与日志级别怎么选不传template参数时服务器自动选默认模板。指定模板时按用途挑场景内置模板按类型什么时候用优化用户提示词basic/planning/professional日常对话选 basic任务要分步骤执行选 planning咨询类回答选 professional优化系统提示词general/analytical/output-format通用角色选 general偏推理分析选 analytical只修输出格式选 output-format迭代改进iterate已有可用提示词做定向修补多模型与本地模型全走环境变量# 同时配置多家再用 MCP_DEFAULT_MODEL_PROVIDER 指定默认 VITE_OPENAI_API_KEYsk-... VITE_DEEPSEEK_API_KEYsk-... MCP_DEFAULT_MODEL_PROVIDERdeepseek # 接 Ollama 等 OpenAI 兼容接口多个模型用后缀区分 VITE_CUSTOM_API_KEY_qwen3占位密钥 VITE_CUSTOM_API_BASE_URL_qwen3http://localhost:11434/v1 VITE_CUSTOM_API_MODEL_qwen3qwen3:8b MCP_DEFAULT_MODEL_PROVIDERcustom_qwen3注意MCP_DEFAULT_MODEL_PROVIDER必须全小写且要和已配置的密钥对得上否则会报模型未配置。日志级别开发用debug跑起来之后调成info嫌吵再降到warn。 Claude Desktop 接入 MCP 工具失败按 4 条清单查服务器起不来报EADDRINUSE→ 端口被别的进程占了 → 换端口启动MCP_HTTP_PORT3001 pnpm mcp:devDocker 部署则改 8081 的映射端口。提示No enabled models found→ 密钥没注入容器或已失效 → 确认启动命令带上了-e VITE_OPENAI_API_KEY...没带就docker restart之前重新带参启动。工具列表里找不到 3 个工具→ 配置 URL 和实际端口对不上或 JSON 写错 → 浏览器访问http://localhost:8081/healthz能通再逐字符比对services.json里的 url。调用工具报模型未配置→MCP_DEFAULT_MODEL_PROVIDER与密钥不匹配常见是写成了大写OpenAI→ 改成小写openai并重启服务。完整故障排除见 MCP 服务器用户指南。 把提示词优化固化成 5 步工作流初稿在 Claude Desktop 里随手写出原始提示词不用讲究。首次优化调用optimize-user-prompt或optimize-system-prompt先不指定模板用默认值。实测拿优化结果跑 2-3 个真实问题记下具体毛病太长、跑题、格式乱。定向迭代把毛病写进requirements调iterate-prompt只修记录的问题。存档定稿后在 prompt-optimizer 的 Web 界面http://localhost:8081存成模板下次直接复用。开发侧细节工具参数定义、Inspector 调试可查 MCP 服务器开发文档。✅ 接入后你拿到了什么省掉了应用间复制粘贴优化发生在对话窗口内部。3 个工具覆盖从零写到改已有的完整链路。一条 Docker 命令起步配置项只有必填的一个密钥。接下来做三件事跑那条docker run等/healthz变绿。写好services.json重启 Claude Desktop确认 3 个工具都出现。挑一句你最常写的提示词走一遍 5 步工作流。【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考