JinDaGe - artifex-mcp MCP Details

article

README

🚀 Artifex MCP

Artifex MCP 是一个支持多供应商的 AI 图像生成 MCP（模型上下文协议）服务器，可帮助用户通过不同的 AI 模型生成和编辑图像。

🚀 快速开始

Artifex MCP 是一个支持多种图像生成模型的服务器，可通过简单的参数在不同供应商之间切换，实现文本到图像的生成和图像编辑等功能。

✨ 主要特性

多供应商支持：可通过简单参数在 Antigravity（默认，使用 Google 的 Gemini 3 Pro Image 模型）和 OpenAI（DALL - E 3）之间切换。
文本到图像生成：根据文本描述生成图像。
图像编辑：使用文本指令修改现有图像（仅 Antigravity 支持）。
多输出结果：每次请求最多可生成 4 种图像变体（仅 Antigravity 支持）。
角色一致性：基于会话的生成方式，确保角色的一致性（仅 Antigravity 支持）。
多宽高比支持：支持 1:1、16:9、9:16、3:4、4:3 等多种宽高比。

📦 安装指南

或者全局安装：

npm install -g artifex-mcp

📚 详细文档

身份验证

Antigravity（默认）

npx artifex-mcp --login

此命令将：

打开浏览器进行 Google OAuth 认证。
将凭证安全地存储在 ~/.config/artifex-mcp/auth.json 中。

OpenAI

设置 OPENAI_API_KEY 环境变量：

export OPENAI_API_KEY=sk-...

使用方法

作为 MCP 服务器

添加到 MCP 客户端配置中： Claude Desktop (claude_desktop_config.json)：

{
  "mcpServers": {
    "artifex": {
      "command": "npx",
      "args": ["artifex-mcp"],
      "env": {
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

OpenCode：

{
    "mcp": {
        "artifex": {
            "type": "local",
            "command": ["npx", "artifex-mcp"],
            "enabled": true,
            "env": {
                "OPENAI_API_KEY": "sk-..."
            }
        }
    }
}

环境变量

| 变量 | 描述 | 默认值 | |------|------|---------| | DEFAULT_IMAGE_PROVIDER | 默认使用的供应商 | antigravity | | DEFAULT_IMAGE_MODEL | 供应商的默认模型 | gemini-3-pro-image | | OPENAI_API_KEY | OpenAI 供应商的 API 密钥 | - |

供应商选择

使用 model 参数，格式为 provider:model：

# 使用 Antigravity（默认）
generate_image({ prompt: "a cat" })

# 使用 OpenAI DALL - E 3
generate_image({ prompt: "a cat", model: "openai:dall-e-3" })

# 使用特定的 Antigravity 模型
generate_image({ prompt: "a cat", model: "antigravity:gemini-3-pro-image" })

可用工具

`generate_image`

根据文本提示生成图像。 | 参数 | 类型 | 是否必需 | 默认值 | 描述 | |-----------|------|----------|---------|-------------| | prompt | 字符串 | 是 | - | 图像描述或编辑指令 | | model | 字符串 | 否 | 环境默认值 | 格式为 provider:model 的供应商和模型 | | aspect_ratio | 枚举 | 否 | "1:1" | 1:1、16:9、9:16、3:4、4:3、2:3、3:2、4:5、5:4、21:9 | | output_path | 字符串 | 否 | 当前工作目录 | 保存图像的目录 | | file_name | 字符串 | 否 | 自动生成 | 自定义文件名 | | input_image | 字符串 | 否 | - | 用于编辑的图像路径（仅 Antigravity 支持） | | count | 数字 | 否 | 1 | 生成图像的数量（1 - 4，仅 Antigravity 支持） | | session_id | 字符串 | 否 | - | 用于角色一致性（仅 Antigravity 支持） |

示例：

# 默认供应商（Antigravity）
Generate a cyberpunk cityscape at night

# 使用 OpenAI
Generate a cyberpunk cityscape at night, model: openai:dall-e-3

# 多图像生成（仅 Antigravity 支持）
Generate 4 variations of a majestic dragon, aspect ratio 16:9

# 角色一致性（仅 Antigravity 支持）
Create a hero named Luna, session_id: luna

`auth_status`

检查供应商的认证状态。 | 参数 | 类型 | 是否必需 | 描述 | |-----------|------|----------|-------------| | provider | 字符串 | 否 | 要检查的供应商（默认：antigravity） |

`auth_login`

获取与供应商进行认证的说明。

`auth_logout`

删除存储的供应商凭证。

`quota_status`

检查供应商的速率限制和配额状态。

供应商功能

| 功能 | Antigravity | OpenAI | |---------|-------------|--------| | 文本到图像生成 | ✅ | ✅ | | 图像编辑 | ✅ | ❌ | | 多图像生成 | ✅ (1 - 4) | ❌ (仅 1 张) | | 会话功能 | ✅ | ❌ | | 宽高比支持 | ✅ | ✅ (有限) | | 认证类型 | Google OAuth | API 密钥 |

文件位置

| 用途 | 位置 | |---------|----------| | 凭证 | ~/.config/artifex-mcp/auth.json | | 会话 | ~/.cache/artifex-mcp/sessions/ | | 生成的图像 | 当前工作目录（或自定义路径） |

故障排除

"未认证" 错误（Antigravity）

npx artifex-mcp --login

"未找到 OpenAI API 密钥" 错误

设置环境变量：

export OPENAI_API_KEY=sk-...

速率限制超出

等待错误消息中指示的时间。速率限制按账户实施。

不支持的功能错误

某些功能仅在特定供应商上可用。例如：

session_id 仅适用于 Antigravity。
input_image（编辑）仅适用于 Antigravity。
count > 1 仅适用于 Antigravity。

📄 许可证

本项目采用 MIT 许可证。

法律声明

预期用途

仅用于个人/内部开发。
遵守配额和数据处理政策。
不得用于生产服务或绕过预期限制。

警告

使用此插件即表示您承认：

服务条款风险 — 此方法可能违反 AI 模型供应商的服务条款。
账户风险 — 供应商可能会暂停或封禁账户。
无保证 — API 可能会在未通知的情况下更改。
风险承担 — 您承担所有法律、财务和技术风险。

免责声明

本项目与 Google 或 OpenAI 无关，是一个独立的开源项目。 "Antigravity"、"Gemini"、"Google Cloud"、"Google"、"OpenAI" 和 "DALL - E" 是其各自所有者的商标。

⚠️ 重要提示

这是一个独立的、社区开发的 MCP 服务器，与 Google 或 OpenAI 没有关联、未得到其认可或支持。使用时请自行承担风险。

artifex-mcp