prompt-optimizer MCP 集成完整指南5 分钟让 Claude Desktop 直接优化你的提示词【免费下载链接】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你无需离开当前对话就能调用专业优化服务。本文带你用 5 分钟从零跑通整个流程最后再讲怎么用好它。️ 原理速览MCP 是怎么工作的MCPModel Context Protocol让 AI 客户端能像调函数一样调用外部工具。prompt-optimizer 内置了一个 MCP 服务器把核心的提示词优化服务打包成 3 个工具优化用户提示词、优化系统提示词、按需求迭代提示词。核心设计点零侵入MCP 服务器只通过适配层调用核心模块不改动核心代码无状态用内存存储每次请求都是干净会话不依赖浏览器登录多客户端基于会话管理支持多个客户端同时连接模型可配通过环境变量选择后端模型提供商支持多家 API 与本地 Ollama 快速通道5 分钟从零到首次成功1. Docker 部署推荐只要装好 Docker 和一个模型 API 密钥一条命令启动docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY你的密钥 \ -e MCP_DEFAULT_MODEL_PROVIDERopenai \ --name prompt-optimizer \ linshen/prompt-optimizer启动后 Web 界面在http://localhost:8081MCP 服务在http://localhost:8081/mcp。想用 Docker Compose 自定义配置的看 MCP 用户指南 即可这里不再展开。如果你不装 Docker也可以克隆仓库后跑pnpm mcp:dev本地启动地址为http://localhost:3000/mcp但普通用户走 Docker 最省事。2. 连接 Claude Desktop先找到 Claude 的配置目录操作系统配置目录Windows%APPDATA%\Claude\servicesmacOS~/Library/Application Support/Claude/servicesLinux~/.config/Claude/services创建或编辑services.json加入一段配置{ services: [ { name: Prompt Optimizer, url: http://localhost:8081/mcp } ] }重启 Claude Desktop。3. 验证点确认它已经工作做两件事curl http://localhost:8081/healthz返回 JSON 且initialized为true说明服务器健康不健康时会返回 503。然后在 Claude 对话里输入/tools应该能看到 3 个工具optimize-user-prompt、optimize-system-prompt、iterate-prompt。工具列表在说明 MCP 集成成功进入下一步实战。️ 实战验证3 个代表用例以下效果为示意输出实际以模型返回为准。用例 1optimize-user-prompt 优化用户提示词适用场景日常对话、问答、创作类请求一句话太模糊导致回答跑偏。怎么用在 Claude 里说用 optimize-user-prompt 工具优化这句提示词帮我写篇文章。优化前优化后帮我写篇文章请撰写一篇约 1500 字的技术文章主题为 AI 在医疗领域的应用要求包含真实案例、语言专业但易懂、按背景—现状—案例—趋势组织结尾给出 3 个延伸问题用例 2optimize-system-prompt 优化系统提示词适用场景定制 AI 角色、专家助手、结构化对话系统角色定义太简单导致行为不可控。怎么用把你是一个助手丢给它要求转成系统提示词。优化前优化后你是一个助手你是一位专业、高效的 AI 助手。职责1. 准确理解用户意图歧义时先澄清2. 回答结构化、可执行3. 不确定时明确说明而非猜测4. 遵守伦理与安全边界拒绝有害请求用例 3iterate-prompt 按需迭代适用场景提示词已经能用但某个具体方面不达标比如输出格式不稳定、语气太公式化。怎么用传入现有提示词 一句具体需求例如输出格式不一致请强制统一为 Markdown 表格。输入输出现有提示词 结果格式混乱要求统一用表格输出保留原有角色与逻辑新增输出规范一节所有对比类结果必须输出为 Markdown 表格列名固定为 项目/方案A/方案B/结论注意iterate-prompt需要同时传prompt和requirements两个参数缺一个都会报错。 进阶玩法模板与多模型模板选择3 个工具都带可选的template参数不传则用默认模板。工具描述里会动态列出当前所有可用模板内置包括基础、专业、规划等风格直接让 Claude用 professional 模板优化即可。模板风格适用场景基础通用场景平衡优化专业增强专业性与准确性规划任务拆解与步骤化表达多模型配置至少配一个 API 密钥其余都是可选。配好后用MCP_DEFAULT_MODEL_PROVIDER指定首选提供商环境变量是否必需默认值说明VITE_OPENAI_API_KEY至少一个无OpenAI 密钥VITE_GEMINI_API_KEY否无Gemini 密钥VITE_DEEPSEEK_API_KEY否无DeepSeek 密钥MCP_DEFAULT_MODEL_PROVIDER否无首选提供商取值如 openai / gemini / deepseek / customMCP_LOG_LEVEL否debug日志级别debug / info / warn / errorMCP_DEFAULT_LANGUAGE否zh默认语言zh / en想接本地 Ollama用自定义 API 三件套VITE_CUSTOM_API_KEY可填 dummy、VITE_CUSTOM_API_BASE_URLhttp://localhost:11434/v1、VITE_CUSTOM_API_MODELqwen2.5:7b再把MCP_DEFAULT_MODEL_PROVIDERcustom。 避坑手册4 个高频问题1. 端口被占用症状Error: listen EADDRINUSE: address already in use原因3000 端口本地部署已被其他进程占用解决本地部署加MCP_HTTP_PORT3001 pnpm mcp:devDocker 部署则把-p 8081:80映射到别的端口2. 报 No enabled models found症状启动时或调用工具时报没有可用模型原因一个有效的 API 密钥都没配上解决确认VITE_OPENAI_API_KEY等变量已注入容器且密钥本身有效3. 模型提供商不生效症状明明配了多个密钥却用了不是想要的模型原因MCP_DEFAULT_MODEL_PROVIDER拼写错误或大小写不对解决取值必须小写写openai而不是OpenAI4. Claude Desktop 连接返回 401症状MCP 客户端连http://localhost:8081/mcp报 401原因Docker 版启用ACCESS_PASSWORD后 Nginx 对所有路由做 Basic 认证MCP 协议不支持这种认证解决v1.4.0 已让/mcp路由绕过认证升级镜像即可旧版本则不设置ACCESS_PASSWORD 收尾速查场景与做法场景推荐做法日常对话请求太模糊optimize-user-prompt 基础模板定制专家角色、助手行为optimize-system-prompt 专业模板现有提示词某项不达标iterate-prompt 写清具体需求不想依赖云端模型自定义 API 指向本地 Ollama连不上、查状态curl http://localhost:8081/healthz下一步行动跑上面的docker run命令用curl确认/healthz返回 200配置services.json重启 Claude Desktop用/tools确认 3 个工具就位挑你最近一次写砸的提示词先optimize一遍再用iterate-prompt精修一处更多部署细节和 Inspector 调试方法可查 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），仅供参考