3 步把 prompt-optimizer 的 MCP 服务接入 Claude Desktop起容器、写配置、用工具【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer这篇文章讲的是怎么把 prompt-optimizer 的 MCP 服务器部署起来并在 Claude Desktop 里配置好、调通它的三个提示词优化工具。假设你已经在用 Claude Desktop 或同类支持 MCP 协议的客户端协议本身不解释只讲怎么配、怎么跑通、怎么用。MCP 在这个项目里是干什么的prompt-optimizer 里的 MCP 服务器本质上是一个 HTTP 协议适配层客户端把工具调用 POST 到/mcp路径服务器把它翻译成内部提示词优化服务的调用再把结果以文本返回。它无状态、用内存存储每个会话独立所以和 Web 界面互不干扰。跑通之后你在对话里直接就能调提示词优化能力不用再复制粘贴到另一个应用。起容器然后接上 Claude DesktopDocker 是最省事的方式容器里 Web 界面和 MCP 服务器一起启动。把 API 密钥导进环境变量或写进.env文件之后一条命令把容器跑起来docker compose -f docker/docker-compose.yml up -d先别急确认一下端口。仓库自带的 compose 文件把宿主机端口映射到28081所以 MCP 地址是http://localhost:28081/mcp。如果你改成别的端口后面的 URL 要跟着改这两个地方对不上是最常见的连不上原因。然后是 Claude Desktop 的services.json。配置文件在用户目录下的Claude/services里Windows 在%APPDATA%\Claude\servicesmacOS 在~/Library/Application Support/Claude/servicesLinux 在~/.config/Claude/services内容就是一个服务列表{ services: [ { name: Prompt Optimizer, url: http://localhost:28081/mcp } ] }重启 Claude Desktop在对话里输入/tools能看到optimize-user-prompt、optimize-system-prompt、iterate-prompt三个工具就算跑通了。这个坑我踩过容器没起来时 Claude Desktop 不会报错得很明确表现就是工具列表里空空如也所以怀疑连接问题时先看容器日志再看 JSON。容器本身对单机个人使用来说资源占用很小没必要在资源限制上花时间。三个工具什么时候用哪个场景工具备注写对话、任务请求这类用户侧提示词optimize-user-promptprompt必填template可选定义 AI 角色、行为规则的系统提示词optimize-system-prompt同上模板池不同手里已有可用提示词要朝特定方向改iterate-prompt额外必填requirements写明改进点optimize-user-prompt适合还没成型的一句话需求把模糊表达清理掉、补上关键约束。参数就两个prompt待优化的原文必填template模板 ID不传用默认模板改前帮我写篇文章改后请撰写一篇约 1500 字、面向非技术读者的文章包含 2 个真实案例采用总-分-总结构语言平实易读。optimize-system-prompt处理角色定义类提示词把你是 XX这种一句话扩写成带 Profile、Skills、Rules 的结构化系统提示词模板池偏向角色与行为约束。参数和上面一致同样是prompt必填、template可选。改前你是一个助手改后你是一名领域顾问用结构化方式回答先给结论再列依据不确定时明确说明不臆造事实输出用中文段落间留空行。iterate-prompt是前两个的后续动作提示词已经能用但输出有具体毛病比如格式飘了、语气不对、某个能力缺失。多传一个requirements把问题说清楚它会保留原提示词的核心意图只做针对性修改不会重写一版面目全非的东西。选工具就看提示词处于哪个阶段从零写用前两个手里有稿子用迭代。模板不确定就先不传跑一次看输出不满意再换。模板怎么选模型怎么配三个工具各自挂一套模板池常用的几个方向模板方向一句话用途基础优化用户快速清理用户提示词里的模糊表达专业优化用户需要专业、结构化输出的场景通用优化系统把一句话角色描述扩成结构化系统提示词通用迭代迭代按指定方向精修已有提示词具体的可选值不用背Claude Desktop 调用工具时会把模板枚举和说明带出来照着选就行。模型侧的配置走环境变量填了哪家 API 密钥MCP_DEFAULT_MODEL_PROVIDER就指哪家配多个密钥时这个变量决定首选。想接本地 Ollama 这类 OpenAI 兼容端点走 custom 通道一行示例VITE_CUSTOM_API_BASE_URLhttp://localhost:11434/v1 VITE_CUSTOM_API_MODELqwen2.5:7b MCP_DEFAULT_MODEL_PROVIDERcustom其余常用变量一表带过变量默认值说明VITE_OPENAI_API_KEY无API 密钥之一至少配一个MCP_DEFAULT_MODEL_PROVIDERopenai首选模型提供商须与密钥对应MCP_LOG_LEVELdebug日志级别 debug/info/warn/errorMCP_DEFAULT_LANGUAGEzh输出语言 zh/enMCP_HTTP_PORT3000本地开发模式端口Docker 内固定 3000 不用管踩过的坑端口被占用本地开发模式启动时出现EADDRINUSE不用去查谁占着端口直接MCP_HTTP_PORT3001 pnpm mcp:dev换个端口起记得services.json里的 URL 端口同步改。找不到可用模型报No enabled models found或提示 MCP 默认模型未配置时十有八九是密钥和提供商对不上。确认至少有一个密钥真的导进了容器环境再把MCP_DEFAULT_MODEL_PROVIDER改成对应那家注意取值是小写openai不是OpenAI。Claude Desktop 连上却返回 401Docker 部署设了ACCESS_PASSWORD时旧镜像的 Nginx 会把 Basic 认证套到所有路由上/mcp也被挡住而 MCP 协议本身不支持 Basic 认证。换到较新的镜像即可新版已让/mcp绕过认证或者干脆不设密码、只在内网用。收尾整条链路就是容器跑起来、services.json指对地址、按提示词所处阶段选工具。后面要查完整环境变量清单和 Inspector 调试方式看仓库里的 docs/user/mcp-server.md 或 README 就够了。【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
3 步把 prompt-optimizer 的 MCP 服务接入 Claude Desktop：起容器、写配置、用工具
3 步把 prompt-optimizer 的 MCP 服务接入 Claude Desktop起容器、写配置、用工具【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer这篇文章讲的是怎么把 prompt-optimizer 的 MCP 服务器部署起来并在 Claude Desktop 里配置好、调通它的三个提示词优化工具。假设你已经在用 Claude Desktop 或同类支持 MCP 协议的客户端协议本身不解释只讲怎么配、怎么跑通、怎么用。MCP 在这个项目里是干什么的prompt-optimizer 里的 MCP 服务器本质上是一个 HTTP 协议适配层客户端把工具调用 POST 到/mcp路径服务器把它翻译成内部提示词优化服务的调用再把结果以文本返回。它无状态、用内存存储每个会话独立所以和 Web 界面互不干扰。跑通之后你在对话里直接就能调提示词优化能力不用再复制粘贴到另一个应用。起容器然后接上 Claude DesktopDocker 是最省事的方式容器里 Web 界面和 MCP 服务器一起启动。把 API 密钥导进环境变量或写进.env文件之后一条命令把容器跑起来docker compose -f docker/docker-compose.yml up -d先别急确认一下端口。仓库自带的 compose 文件把宿主机端口映射到28081所以 MCP 地址是http://localhost:28081/mcp。如果你改成别的端口后面的 URL 要跟着改这两个地方对不上是最常见的连不上原因。然后是 Claude Desktop 的services.json。配置文件在用户目录下的Claude/services里Windows 在%APPDATA%\Claude\servicesmacOS 在~/Library/Application Support/Claude/servicesLinux 在~/.config/Claude/services内容就是一个服务列表{ services: [ { name: Prompt Optimizer, url: http://localhost:28081/mcp } ] }重启 Claude Desktop在对话里输入/tools能看到optimize-user-prompt、optimize-system-prompt、iterate-prompt三个工具就算跑通了。这个坑我踩过容器没起来时 Claude Desktop 不会报错得很明确表现就是工具列表里空空如也所以怀疑连接问题时先看容器日志再看 JSON。容器本身对单机个人使用来说资源占用很小没必要在资源限制上花时间。三个工具什么时候用哪个场景工具备注写对话、任务请求这类用户侧提示词optimize-user-promptprompt必填template可选定义 AI 角色、行为规则的系统提示词optimize-system-prompt同上模板池不同手里已有可用提示词要朝特定方向改iterate-prompt额外必填requirements写明改进点optimize-user-prompt适合还没成型的一句话需求把模糊表达清理掉、补上关键约束。参数就两个prompt待优化的原文必填template模板 ID不传用默认模板改前帮我写篇文章改后请撰写一篇约 1500 字、面向非技术读者的文章包含 2 个真实案例采用总-分-总结构语言平实易读。optimize-system-prompt处理角色定义类提示词把你是 XX这种一句话扩写成带 Profile、Skills、Rules 的结构化系统提示词模板池偏向角色与行为约束。参数和上面一致同样是prompt必填、template可选。改前你是一个助手改后你是一名领域顾问用结构化方式回答先给结论再列依据不确定时明确说明不臆造事实输出用中文段落间留空行。iterate-prompt是前两个的后续动作提示词已经能用但输出有具体毛病比如格式飘了、语气不对、某个能力缺失。多传一个requirements把问题说清楚它会保留原提示词的核心意图只做针对性修改不会重写一版面目全非的东西。选工具就看提示词处于哪个阶段从零写用前两个手里有稿子用迭代。模板不确定就先不传跑一次看输出不满意再换。模板怎么选模型怎么配三个工具各自挂一套模板池常用的几个方向模板方向一句话用途基础优化用户快速清理用户提示词里的模糊表达专业优化用户需要专业、结构化输出的场景通用优化系统把一句话角色描述扩成结构化系统提示词通用迭代迭代按指定方向精修已有提示词具体的可选值不用背Claude Desktop 调用工具时会把模板枚举和说明带出来照着选就行。模型侧的配置走环境变量填了哪家 API 密钥MCP_DEFAULT_MODEL_PROVIDER就指哪家配多个密钥时这个变量决定首选。想接本地 Ollama 这类 OpenAI 兼容端点走 custom 通道一行示例VITE_CUSTOM_API_BASE_URLhttp://localhost:11434/v1 VITE_CUSTOM_API_MODELqwen2.5:7b MCP_DEFAULT_MODEL_PROVIDERcustom其余常用变量一表带过变量默认值说明VITE_OPENAI_API_KEY无API 密钥之一至少配一个MCP_DEFAULT_MODEL_PROVIDERopenai首选模型提供商须与密钥对应MCP_LOG_LEVELdebug日志级别 debug/info/warn/errorMCP_DEFAULT_LANGUAGEzh输出语言 zh/enMCP_HTTP_PORT3000本地开发模式端口Docker 内固定 3000 不用管踩过的坑端口被占用本地开发模式启动时出现EADDRINUSE不用去查谁占着端口直接MCP_HTTP_PORT3001 pnpm mcp:dev换个端口起记得services.json里的 URL 端口同步改。找不到可用模型报No enabled models found或提示 MCP 默认模型未配置时十有八九是密钥和提供商对不上。确认至少有一个密钥真的导进了容器环境再把MCP_DEFAULT_MODEL_PROVIDER改成对应那家注意取值是小写openai不是OpenAI。Claude Desktop 连上却返回 401Docker 部署设了ACCESS_PASSWORD时旧镜像的 Nginx 会把 Basic 认证套到所有路由上/mcp也被挡住而 MCP 协议本身不支持 Basic 认证。换到较新的镜像即可新版已让/mcp绕过认证或者干脆不设密码、只在内网用。收尾整条链路就是容器跑起来、services.json指对地址、按提示词所处阶段选工具。后面要查完整环境变量清单和 Inspector 调试方式看仓库里的 docs/user/mcp-server.md 或 README 就够了。【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
