让 Claude Desktop 直接优化提示词：prompt-optimizer MCP 接入实战指南-迪斯科星球

让 Claude Desktop 直接优化提示词：prompt-optimizer MCP 接入实战指南

【免费下载链接】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 协议（Model Context Protocol）服务器，把它跑起来之后，Claude Desktop 就能像调用本地工具一样直接让它干活，来回切换的环节全部省掉。

MCP 集成能带来什么

MCP 是 Anthropic 提出的开放协议，作用是把外部工具标准地"插"给 AI 助手。prompt-optimizer 通过 MCP 暴露了三个工具：优化用户提示词、优化系统提示词、迭代已有提示词。你在 Claude 对话里说一句需求，Claude 自己调工具、自己把优化结果贴回来，你只需要看产出。整个过程不需要复制粘贴，也不需要记任何 API 地址。

Docker 一条命令部署

普通用户建议只走 Docker 这一条路，Web 界面和 MCP 服务器会同时启动：

docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY=你的API密钥 \ -e MCP_DEFAULT_MODEL_PROVIDER=openai \ --name prompt-optimizer \ linshen/prompt-optimizer

起完在浏览器打开http://localhost:8081确认 Web 界面正常；再跑一条命令确认 MCP 端点活着，有 JSON 应答就说明部署成功：

curl -i -X POST http://localhost:8081/mcp

Claude Desktop 接入配置

各系统的services.json所在目录不同，先按系统找到位置：

操作系统	配置文件位置
Windows	`%APPDATA%\Claude\services\services.json`
macOS	`~/Library/Application Support/Claude/services/services.json`
Linux	`~/.config/Claude/services/services.json`

创建或编辑这个文件，内容如下：

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

重启 Claude Desktop，新开会话后在对话里说一句"列出你当前可用的工具"，回复里能看到optimize-user-prompt、optimize-system-prompt、iterate-prompt三个，接入就算成了。

三个典型任务

三个工具对应三类需求，各看一组效果对比就明白了。

1. optimize-user-prompt：把一句话需求变成可执行的要求

优化前	优化后（示意）
帮我写篇文章	撰写一篇约1500字、面向非技术读者、含3个真实案例和1个对比表格的AI医疗应用科普文章，结论部分单列

2. optimize-system-prompt：把角色设定补全成完整规范

优化前	优化后（示意）
你是一个代码审查助手	资深代码审查助手：按严重级别输出问题清单，每条附行号、原因和修改建议，无问题时明确说明，不臆测业务背景

3. iterate-prompt：针对具体问题定向改进

优化前	优化后（示意）
你是客服机器人（配合要求：回答太啰嗦）	客服机器人：先给结论再给步骤，单次回复不超过80字，能一句话解决的不用一段话

迭代工具多一个必填参数requirements，把"哪里不好"说具体，它才会保留原意只做定向修改。

选择与配置速查

项目	取值	说明
模板参数`template`	可选	不填用内置默认；可选值含 user-prompt-basic（基础优化）、user-prompt-professional（专业优化）、user-prompt-planning（规划型优化）等，在 Claude 里问一句"列出可选模板"能看到全量清单
`VITE_OPENAI_API_KEY`等	至少一个密钥	支持 OpenAI、Gemini、DeepSeek 等，前缀统一为`VITE_`加模型方名加`_API_KEY`
`MCP_DEFAULT_MODEL_PROVIDER`	如`openai`	配了多个密钥时指定优先用哪家，名称必须全小写
`MCP_LOG_LEVEL`	`debug`/`info`/`warn`/`error`	默认 debug，生产环境建议`info`
`MCP_HTTP_PORT`	默认`3000`	仅本地开发部署需要改，Docker 部署走 8081 无需设置

排障速查

症状	处理
`EADDRINUSE: address already in use`	端口被占用：查`netstat -ano \| findstr :3000`（Linux 用`ss -lntp`），换`MCP_HTTP_PORT`或停掉占用进程
`No enabled models found`	密钥没配对或没生效：确认`VITE_`前缀的变量名拼写正确、密钥余额有效，改完重启容器
Claude Desktop 连不上	浏览器先访问`http://localhost:8081`确认服务活着；再核对 services.json 的 URL 和引号；最后看 Claude Desktop 日志
`Missing required parameter 'prompt'`	工具调用参数缺失：`prompt`为必填，`iterate-prompt`还必填`requirements`
配了`ACCESS_PASSWORD`后 MCP 返回 401	旧版会拦截 /mcp 路由，升级到 v1.4.0+ 或干脆不启用密码

折腾到这里，一个能用的"提示词优化器 + Claude Desktop"组合就跑起来了：容器负责干活，配置文件只有一行，剩下的交给对话。建议按这个顺序试：先用optimize-user-prompt处理一句你真实要用的提示词，感受下效果；再挑一个你维护的系统提示词过一遍optimize-system-prompt；如果输出不满意，别重写，用iterate-prompt把问题说具体让它定向改。更多细节可以参考 MCP 服务器用户指南。

【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析