prompt-optimizer 接入 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
把 prompt-optimizer 的提示词优化能力做成一个 MCP 服务,挂到 Claude Desktop 上,你在聊天框里就能直接调用优化、迭代提示词,不用来回切窗口。
它帮你省掉了什么
过去写提示词要手动复制进专门的工具、等结果再粘回来,来回搬运很琐碎。接上 MCP 之后,Claude 把优化当成一个内置技能调用,你只管说需求,改完直接拿回结果。说白了,就是把"提示词优化"这件事从你手上挪到了 AI 工作流里。
从零跑起来:一条命令拉起服务
最快的路径是用 Docker 跑起来,它会同时带上 Web 界面和 MCP 服务:
docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY=你的OpenAI密钥 \ -e MCP_DEFAULT_MODEL_PROVIDER=openai \ --name prompt-optimizer \ linshen/prompt-optimizer跑完后 Web 界面在http://localhost:8081,MCP 端点在http://localhost:8081/mcp。
几个可选配置(都不影响启动):
- 想拉镜像快一点,国内可换阿里云镜像源
registry.cn-guangzhou.aliyuncs.com/prompt-optimizer/prompt-optimizer - 需要多模型时,追加对应密钥,如
VITE_GEMINI_API_KEY、VITE_DEEPSEEK_API_KEY - 日志级别
MCP_LOG_LEVEL(默认 debug,可设 info/warn/error) - 默认语言
MCP_DEFAULT_LANGUAGE(默认 zh,可设 en)
想要更细的编排,可以参考仓库里的 docker/ 目录,或直接读 MCP 用户指南。
接入 Claude Desktop:找配置、改文件、验证
- 找到配置目录
- Windows:
%APPDATA%\Claude\services - macOS:
~/Library/Application Support/Claude/services - Linux:
~/.config/Claude/services
- Windows:
- 在里面新建或编辑
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:日常对话、问答、创作时把模糊的问法变具体。调用只需给
prompt(template可选,不填走默认)。例:把"帮我写篇文章"扩写成带主题、字数、结构要求的完整指令。 - optimize-system-prompt:给 AI 定角色、定行为边界时用。例:把"你是一个助手"补全成职责、风格、伦理约束都讲清楚的系统提示词。
- iterate-prompt:已有能用的提示词,想针对具体问题微调时用,要同时给
prompt和requirements。例:现有提示词偏公式化,要求"提升创意性、减少套话",它会在保留原意的前提下降级式改进。
进阶玩法
- 模板:三个工具的
template都可选,不传就用默认内置模板;项目里内置了基础、专业、规划等几套,按场景挑。 - 多模型:同时配多家密钥,用
MCP_DEFAULT_MODEL_PROVIDER指定默认(openai、gemini、deepseek、custom 等)。 - 本地 Ollama:走自定义 API 即可,配
VITE_CUSTOM_API_BASE_URL(如http://localhost:11434/v1)、VITE_CUSTOM_API_MODEL,并把 provider 设为 custom。 - 日志:排障时把
MCP_LOG_LEVEL调成 debug 看细节,日常用 info 更安静。
踩坑速查
- 启动报
EADDRINUSE:端口被占。本地开发可MCP_HTTP_PORT=3001 pnpm mcp:dev换个端口。 - 报
No enabled models found:没有可用模型。确认至少配了一个有效密钥,且MCP_DEFAULT_MODEL_PROVIDER拼写小写正确(写 openai,别写 OpenAI)。 - Claude 连不上:先确认服务在跑、
services.json是合法 JSON、防火墙没拦本地连接。 - 工具调用报缺参:
iterate-prompt必须同时传prompt和requirements,只给一半会报错。
总结:一条 Docker 命令起服务,改一个services.json,/tools看到三个工具,你的提示词优化助手就算配好了。 下一步:按上面把服务跑起来,挑一个手头的提示词丢给 optimize-user-prompt 试一把,源码细节可翻 packages/mcp-server/。
【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考