2Xapi.com GPT-image MCP Server

把 OpenAI 兼容的文生图接口封装成 MCP 工具。接入 Claude Code / Codex / Cursor / Claude Desktop 等客户端后，对话里说「画一只柴犬」就能出图。每位用户使用自己的 API Key，消耗计费到各自账号。

• 🤖 AI 一键部署：把仓库地址发给任何 AI（Codex / Claude），它会读 AGENTS.md 自动完成部署

• ⚡ 一键脚本（二选一）：

  • ./install.sh（需先发布 GitHub Release）：IMAGE_API_KEY=你的key ./install.sh，自动检测 claude/codex 并接入

  • ./deploy.sh（本地构建，不依赖 Release）：./deploy.sh --client codex --key 你的key

• 📄 部署文档：GPT-image MCP Server部署文档.md（约 5 分钟，含给 AI 的提示词模板）

• 🐍 Python 版：src/（手动部署用，支持 uvx / uv run）

• ⚡ npm 版：gpt-image-mcp-server/（一键安装，推荐）

一键安装（npm 版，推荐）

前提：Node.js 18+。发布到 GitHub Releases 后：

Claude Code

claude mcp add -s user gpt-image \
  --env IMAGE_API_KEY=你的key \
  -- npx -y https://github.com/wenkezhi8/2Xapi.com-GPT-image-MCP-Server/releases/download/v0.1.0/gpt-image-mcp-server-0.1.0.tgz

Codex

codex mcp add GPT-image \
  --env IMAGE_API_KEY=你的key \
  -- npx -y https://github.com/wenkezhi8/2Xapi.com-GPT-image-MCP-Server/releases/download/v0.1.0/gpt-image-mcp-server-0.1.0.tgz

Claude Desktop / Cursor（手动配置）

{
  "mcpServers": {
    "GPT-image": {
      "command": "npx",
      "args": ["-y", "https://github.com/wenkezhi8/2Xapi.com-GPT-image-MCP-Server/releases/download/v0.1.0/gpt-image-mcp-server-0.1.0.tgz"],
      "env": {
        "IMAGE_API_KEY": "你的key"
      }
    }
  }
}

Related MCP server: Flow2API MCP Server

环境变量

key 与端点必须配套：你的 key 是哪家供应商的，端点就填哪家的。

默认端点说明

• 本项目默认端点：https://2xa.cc.cd/v1 —— 这是 2xapi.com 中转站的 OpenAI 兼容生图接口（官网 https://2Xapi.com），本 MCP 默认配套的就是这个方案。

• 使用 2xapi.com 中转站的 API Key 可直接运行，无需配置端点。

• 如果想使用其他 API 端点（OpenAI 官方、Azure、其他中转站等），需要自己更换：

  • 一键安装/npx 方式：设置环境变量 IMAGE_API_BASE_URL=https://你的端点/v1

  • Python 版：修改 config.json 的 api_base_url 字段

  • 更换后 key 必须与该端点配套，否则报 401。

工具

目录结构

.
├── GPT-image MCP Server部署文档.md   ← 部署文档（必读）
├── gpt-image-mcp-server/            ← npm 版（TypeScript，一键安装）
├── src/                             ← Python 版（uvx/uv run）
├── pyproject.toml / uv.lock
└── LICENSE

安全

• config.json 含真实 API Key，已被 .gitignore 排除，不要提交、不要外发。

• 分发代码前删除 config.json；只保留 config.example.json 模板。