mcpField
G
GPT Image 2.5 MCP

GPT Image 2.5 MCP

已认证精选本地服务
you.bot媒体与设计05 周前更新

关于 GPT Image 2.5 MCP

GPT Image 2.5 MCP 可在 Claude、Cursor 等 MCP 客户端中生成和编辑图像。它使用 you.bot API 密钥,并提供额度查询功能。

主要功能

  1. 01根据文本提示生成图像
  2. 02编辑公共 URL 中的图像
  3. 03查询剩余额度
  4. 04将生成图像保存为 PNG

适用场景

  1. 01根据聊天提示创建插画
  2. 02替换现有图像的背景
  3. 03生成图像前查询额度

MCP 相关

MCP 服务提供 `generate_image`、`edit_image`、`check_credits` 工具和设置提示词。客户端通过 stdio 连接,调用时使用 you.bot API 密钥。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"youbotapi-gpt-image": {
"command": "npx",
"args": [
"-y",
"gpt-image-2-5-mcp"
],
"env": {
"YOUBOT_API_KEY": "<YOUBOT_API_KEY>",
"YOUBOT_IMAGE_DIR": "<YOUBOT_IMAGE_DIR>"
}
}
}
}
启动命令npx -y gpt-image-2-5-mcp
需要配置的环境变量
YOUBOT_API_KEY密钥API key from you.bot — NOT an OpenAI key. Free at https://you.bot, 50 credits (~17 images) on signup, no credit card. Keys start with sk-live-.
YOUBOT_IMAGE_DIROptional. If set, every generated image is also saved to this folder.

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmgpt-image-2-5-mcp0.2.2

工具

3

收录的工具列表 · 更新于 2 周前

参数类型必填说明
promptstring是要绘制的内容。详细具体的描述效果最佳,包括主体、场景、光照、构图和风格。若要在图像中加入文字,请用引号准确写出。
aspect_ratioenum否图像的形状。默认为 1:1(正方形)。1:1 | 3:2 | 2:3 | 4:3 | 3:4 | 16:9 | 9:16 | 2:1 | 1:2 | 21:9

详细介绍

GPT Image 2.5 MCP 服务

直接在 Claude、Cursor 或任何 MCP 客户端中,使用 GPT Image 2.5——OpenAI 最强大的图像模型——生成和编辑图像。每张图像 $0.029。

npm license

向 Claude 要一张图片,它就会在聊天中给你生成:

“一台友善的机器人正在阳光充足的工作室里用画架作画,温暖的晨光透过高大的窗户,柔和的阴影,细致的插画风格,画架上有一块小木牌,上面写着‘GPT IMAGE 2.5’”

GPT Image 2.5 的示例输出

使用此服务生成,耗时 45 秒,费用为 $0.029。请注意,木牌上的文字完全符合要求——GPT Image 2.5 在图像中生成文字方面表现格外出色。


⚠️ 请先阅读:API 密钥来自 you.bot,而非 OpenAI

此服务通过 you.bot 调用 GPT Image 2.5。you.bot 是一个 API 网关,以低于 OpenAI 官方费率的价格转售该模型。

  • 你需要一个 you.bot API 密钥。密钥以 sk-live- 开头。
  • OpenAI 密钥无法使用,而且你完全不需要 OpenAI 账户。
  • 如果误填了 OpenAI 密钥,服务会明确告知你,而不是只返回令人困惑的 401 错误。

使用它的原因: 注册即可获得 50 个免费额度——约可生成 17 张图像,无需信用卡,因此粘贴密钥后服务就能立即使用。


设置

1. 获取免费密钥(2 分钟)
  1. 在 https://you.bot 注册——无需信用卡。
  2. 注册后即可获得 50 个额度 ≈ 17 张图像。
  3. 在 https://you.bot/dashboard/api-keys 创建密钥并复制(密钥以 sk-live- 开头)。
2. 将服务添加到客户端
Claude Desktop

编辑 claude_desktop_config.json (macOS:~/Library/Application Support/Claude/,Windows:%APPDATA%\Claude\):

{
  "mcpServers": {
    "gpt-image": {
      "command": "npx",
      "args": ["-y", "gpt-image-2-5-mcp"],
      "env": {
        "YOUBOT_API_KEY": "sk-live-your-key-from-you.bot"
      }
    }
  }
}

重启 Claude Desktop。

Claude Code
claude mcp add gpt-image -e YOUBOT_API_KEY=sk-live-your-key -- npx -y gpt-image-2-5-mcp
Cursor

在 ~/.cursor/mcp.json 中配置(或前往“设置” → MCP → 添加新服务):

{
  "mcpServers": {
    "gpt-image": {
      "command": "npx",
      "args": ["-y", "gpt-image-2-5-mcp"],
      "env": { "YOUBOT_API_KEY": "sk-live-your-key-from-you.bot" }
    }
  }
}
任何其他 MCP 客户端

在环境中设置 YOUBOT_API_KEY,然后通过标准输入/输出运行 npx -y gpt-image-2-5-mcp。

3. 检查是否正常工作

向助手提问:“检查我的图像额度”。你应该能看到余额以及可生成的图像数量。


工具

工具功能费用
generate_image根据文本提示词生成图像2.9 个额度($0.029)
edit_image根据公开 URL 修改现有图像——更换背景、添加或移除对象、改变风格2.9 个额度($0.029)
check_credits显示剩余余额和可生成的图像数量免费

此外还提供 setup 提示词,可在遇到问题时引导你完成配置。

宽高比: 1:1(默认)、3:2、2:3、4:3、3:4、16:9、9:16、2:1、1:2、21:9

输出尺寸固定为 1024px(1K),因此每次调用的费用都是 $0.029。生成通常需要 30–60 秒;服务会持续轮询,直到图像准备就绪,然后将其直接显示给你。


费用

每张图像$0.029
注册免费额度50 个额度 ≈ 17 张图像,无需信用卡
额度价值1 个额度 = $0.01
有效期额度永不过期
生成失败自动退款

每生成一张图像后,服务都会告知你费用;check_credits 则不会消耗任何额度。


可选设置

环境变量作用
YOUBOT_API_KEY必需。 你的 you.bot 密钥(sk-live-…)
YOUBOT_IMAGE_DIR如果设置,生成的每张图像也会以 PNG 格式保存到此文件夹

提升图像效果的提示

GPT Image 2.5 能更好地处理较长且具体的提示词。请描述主体、场景、光线、构图和风格,而不是堆叠关键词。

它也能准确渲染图像中的文字——因此,如果你想在海报或标牌上显示文字,请准确引用:

"一块极简风格的咖啡馆招牌,上面写着“每日营业 7AM”,采用简洁的无衬线字体,温暖的晨光,浅景深"

对于 edit_image,请说明要更改的内容以及需要保留的内容:

"将背景替换为下雪的森林。主体、姿势和光线保持不变。"


故障排查

“未找到 API 密钥” — YOUBOT_API_KEY 未传递到服务。请检查它是否位于 MCP 配置的 env 块中,然后彻底重启客户端。

“这个密钥看起来像 OpenAI API 密钥” — 提示说的就是这种情况。请改为从 https://you.bot 获取密钥;密钥以 sk-live- 开头。

“积分不足” — 每张图像消耗 2.9 积分。请在 https://you.bot 充值;积分永不过期。

没有反应/未提供工具 — 确认客户端已加载该服务(Claude Desktop 会在工具图标下列出它),并确认你使用的是 Node 18 或更高版本。


链接

采用 MIT 许可证。与 OpenAI 无关联;GPT Image 2.5 通过 you.bot API 使用。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。