Productai

ProductAI 插件和 MCP 服务

ProductAI 的 Codex 插件和 MCP 服务——生成 AI 驱动的产品照片。

此代码库包含：

• 可安装的 Codex 插件清单，位于 .codex-plugin/plugin.json
• ProductAI 工作流指南，位于 skills/productai-workflows/
• 独立的 MCP 程序包，位于 mcp/productai/
• TypeScript MCP 源代码，位于 src/

工具

工具	描述
generate_image	根据图片 URL 和提示词生成产品照片
generate_and_wait	生成图片并轮询，直到结果就绪（一步完成）
get_job	查看生成任务状态
wait_for_job	轮询，直到任务完成

模型

nanobanana2.1（默认）、nanobananapro（最高质量）、gpt-low、gpt-medium、gpt-high、gpt-1.5、gpt-2、gpt-2.5、gpt-2.5-precise、kontext-pro、kontext-max、nanobanana、nanobanana2、seedream、seedream-5-lite、seedream-5-pro

• gpt-2.5 — OpenAI GPT Image 2.5，最出色的 GPT 模型：图像质量优于 gpt-2，速度也更快（约 11 秒）。10 个积分。
• gpt-2.5-precise — GPT Image 2.5 精准编辑版本：只更改提示词要求的内容，并保持产品、构图和背景不变。最适合对现有照片进行小范围定向编辑。速度稍慢（约 15–20 秒）。10 个积分。
• nanobanana2.1 — Google Nano Banana 2.1，是 nanobanana2 的后继版本：消耗相同的 5 个积分，质量更高。

gpt-1.5、gpt-2、gpt-2.5、gpt-2.5-precise、nanobanana、nanobananapro、nanobanana2、nanobanana2.1、seedream、seedream-5-lite 和 seedream-5-pro 模型支持多图输入（最多包含 5 个图片 URL 的数组；seedream-5-lite / seedream-5-pro 最多支持 10 个）。

ProductAI API 也支持在不提供 image_url 的情况下使用 gpt-1.5、gpt-2、gpt-2.5 和 gpt-2.5-precise（文生图），但这些 MCP 工具目前始终需要图片 URL。

设置

安装为 Codex 插件

从此代码库安装插件，然后在用于启动 Codex 的环境中设置 PRODUCTAI_API_KEY。插件会启动捆绑的 MCP 服务 mcp/productai/index.js。

从 ProductAI API 访问控制面板获取 API 密钥。

从源代码运行 MCP 服务

1. 获取 API 密钥

在 ProductAI 注册，然后从控制面板获取 API 密钥。

2. 构建

cd productai-mcp
npm install
npm run build

3. 配置 MCP 客户端

在任何兼容 stdio 的 MCP 客户端中使用构建后的服务。对于 Claude Desktop，请将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "productai": {
      "command": "node",
      "args": ["/FULL/PATH/TO/productai-mcp/dist/index.js"],
      "env": {
        "PRODUCTAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

提示： 如果找不到 node，请在 command 字段中使用 Node.js 二进制文件的完整路径。你可以在终端中运行 which node 查找路径（例如 "/Users/you/.nvm/versions/node/v22.0.0/bin/node"）。

初次使用 MCP？如何添加第一个 MCP 服务

如果你是第一次添加 MCP 服务，可以按以下步骤开始：

Claude Desktop：

1. 打开 Claude Desktop
2. 前往 Settings > Developer > Edit Config
3. 这会打开 claude_desktop_config.json 文件。粘贴上方第 3 步中的配置（替换完整路径和 API 密钥）
4. 保存文件并重启 Claude Desktop
5. 你应该能在聊天中看到 ProductAI 工具（查找锤子图标）

Cursor：

1. 打开 Cursor 设置（Mac 上按 Cmd+,，Windows 上按 Ctrl+,）
2. 在设置中搜索“MCP”
3. 点击 Add new MCP server
4. 添加上方第 3 步中的配置
5. 重启 Cursor

Claude Code（CLI）：

运行此命令（替换路径和 API 密钥）：

claude mcp add productai -- node /FULL/PATH/TO/productai-mcp/dist/index.js

然后设置环境变量：

export PRODUCTAI_API_KEY="your-api-key-here"

使用示例

“生成一张这双鞋放在白色大理石表面上的产品照片”（附图片 URL）

“使用 kontext-pro 模型为这张产品图片添加太阳镜”

“查看我的 ProductAI 任务 245922 的状态”