prompt-optimizer 接入 Claude DesktopMCP 协议部署与配置指南【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizerprompt-optimizer 是一个提示词优化工具通过 MCP 协议把它的能力以工具形式暴露给 Claude Desktop 调用。本文走一遍完整的 MCP 服务器部署与 services.json 配置流程最后逐个验证三个提示词优化工具。先看清调用链路再动手这一节只用四层关系说明数据流向后面看到 URL 和端口时就不会迷路。Claude DesktopMCP 客户端发起方按 MCP 的 Streamable HTTP 协议向服务器的/mcp端点发请求MCP 服务器prompt-optimizer 内置接收 JSON-RPC 消息校验参数、映射到内部调用再回传结果核心服务层提示词优化、模板管理、模型管理三组服务通过适配层接入不改动核心代码存储内存实现、无状态每个请求独立处理多个客户端可同时连接。准备工作镜像、端口与密钥开始部署前确认三件事本机装好 Docker 和 Docker Compose至少准备一个可用的模型 API 密钥OpenAI、Gemini、DeepSeek 任选其一宿主机 8081 端口空闲容器内 Web 与 MCP 服务共用 80 端口对外映射。镜像来源两个官方linshen/prompt-optimizer国内网络可改用阿里云广州镜像registry.cn-guangzhou.aliyuncs.com/prompt-optimizer/prompt-optimizer拉取速度更快。5 分钟完成 Docker 部署这一节完成镜像拉取和服务启动两条路径任选其一。路径一单条 docker rundocker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY你的API密钥 \ -e MCP_DEFAULT_MODEL_PROVIDERopenai \ --name prompt-optimizer \ linshen/prompt-optimizer国内加速版本只需把最后的镜像名换成registry.cn-guangzhou.aliyuncs.com/prompt-optimizer/prompt-optimizer其余参数不变。启动后两个地址Web 界面http://localhost:8081MCP 端点http://localhost:8081/mcp路径二Docker Compose需要固定配置或后续扩展时用 Compose 更清晰services: prompt-optimizer: image: linshen/prompt-optimizer:latest container_name: prompt-optimizer restart: unless-stopped ports: - 8081:80 environment: - VITE_OPENAI_API_KEY你的API密钥 - VITE_GEMINI_API_KEY你的API密钥 - VITE_DEEPSEEK_API_KEY你的API密钥 - MCP_DEFAULT_MODEL_PROVIDERopenai - MCP_LOG_LEVELinfo - MCP_DEFAULT_LANGUAGEzh环境变量一览变量必需默认值用途VITE_OPENAI_API_KEY是三选一无OpenAI 密钥VITE_GEMINI_API_KEY否无Gemini 密钥VITE_DEEPSEEK_API_KEY否无DeepSeek 密钥MCP_DEFAULT_MODEL_PROVIDER否openai配了多把密钥时的首选提供商MCP_LOG_LEVEL否debug日志级别debug / info / warn / errorMCP_DEFAULT_LANGUAGE否zh输出语言zh / en确认启动成功的方式浏览器访问http://localhost:8081能看到 Web 界面健康检查端点/healthz返回 200 即可继续下一步。配置 services.json 并接入 Claude Desktop这一节改一个 JSON 文件然后重启客户端验证连通。先找到 Claude Desktop 的配置目录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。在输入框键入/tools工具列表里出现optimize-user-prompt、optimize-system-prompt、iterate-prompt三项接入就算完成。上手实操三个工具各管一件事三个工具覆盖提示词优化的三个典型动作参数都很少直接看示例。optimize-user-prompt —— 优化用户提示词适合日常问答、写作、任务型请求把模糊的说法改具体optimizeUserPrompt({ prompt: 帮我写篇文章, template: default // 可选 })一句模糊指令会返回带字数、结构、风格约束的完整请求。optimize-system-prompt —— 优化系统提示词适合角色定义、行为规范这类系统级内容optimizeSystemPrompt({ prompt: 你是一个助手, template: professional // 可选 })优化前是你是一个助手优化后是包含角色定位、职责清单、行为边界和伦理约束的完整系统提示词——这是三类工具中改造幅度最大的一个。iterate-prompt —— 迭代改进已有提示词提示词已经能用但不够好时用它requirements参数必填说明要改什么iteratePrompt({ prompt: 现有提示词全文, requirements: 增强创意性减少公式化表达, template: creative // 可选 })它保留原提示词的核心意图只针对你指出的问题做定向调整。按需调整模板、多模型与本地模型部署跑通后这几项配置按需求再动模板选择五个内置模板各有侧重——default通用平衡、professional专业准确、creative创意写作、technical技术逻辑、concise压缩冗余。不传template参数时使用内置默认模板。多模型同时配置多家密钥MCP_DEFAULT_MODEL_PROVIDER决定优先用哪家值必须小写openai而非OpenAI。接入 Ollama 等 OpenAI 兼容 APIVITE_CUSTOM_API_KEY_ollama占位密钥 VITE_CUSTOM_API_BASE_URL_ollamahttp://localhost:11434/v1 VITE_CUSTOM_API_MODEL_ollamaqwen2.5:7b MCP_DEFAULT_MODEL_PROVIDERcustom日志级别排查问题设MCP_LOG_LEVELdebug稳定运行后用info只需盯错误就调warn或error。排错速查四类常见症状按看到什么 → 为什么 → 怎么办对照处理EADDRINUSE: address already in use→ 端口被占用。先查占用netstat -ano | findstr :3000再换端口启动例如MCP_HTTP_PORT3001 pnpm mcp:dev。No enabled models found→ 密钥没配上或无效。确认环境变量名拼写无误、密钥仍在有效期再核对MCP_DEFAULT_MODEL_PROVIDER的值与实际密钥匹配。Claude Desktop 连不上→ 按顺序检查服务器是否在运行浏览器访问http://localhost:8081/mcp、services.json的 JSON 格式是否合法、防火墙是否放行本地端口最后再看客户端日志。工具调用报缺少必需参数 prompt→ 调用时没带prompt用iterate-prompt时同样要带requirements。参数补齐后重发即可。更多细节可查阅仓库内的 MCP 服务器用户指南 和 mcp-server 模块说明。收尾与下一步行动到这里prompt-optimizer 的 MCP 服务器已经跑起来Claude Desktop 也能直接调它的三个优化工具了日常请求丢给 optimize-user-prompt角色定义丢给 optimize-system-prompt成熟提示词的定向微调交给 iterate-prompt。之后建议按这个顺序推进选定部署方式把容器稳定运行起来写好services.json用/tools确认三个工具在列拿一条真实提示词走一遍优化 → 实测 → 迭代的完整流程有本地模型需求时再补上自定义 API 配置。【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考