AI导哈

AI图像生成协议服务器

Artifex MCP是一款支持多提供商（包括Google的Gemini 3 Pro和OpenAI的DALL-E 3）的AI图像生成协议服务器，提供文本到图像生成、图像编辑、多输出和字符一致性等功能。

  • by jkalasas
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 jkalasas/artifex-mcp

使用说明

Artifex MCP

⚠️ 非官方工具：这是一个独立的、社区开发的MCP服务器。它不隶属于谷歌或OpenAI，也不受谷歌或OpenAII的认可或支持。使用风险自负。

用于AI图像生成的MCP（模型上下文协议）服务器，支持多个提供商：

  • 反重力 （默认）-谷歌的Gemini 3 Pro Image型号
  • 开放人工智能 DALL-E 3

特性

  • 多提供商支持：使用一个简单的参数在Antigravity和OpenAI之间切换
  • 文本到图像：根据文本描述生成图像
  • 图像编辑：使用文本指令修改现有图像（仅限反重力）
  • 多个输出：每个请求最多生成4个图像变体（仅限反重力）
  • 角色一致性：基于会话的一致字符生成（仅限反重力）
  • 多宽高比1:1、16:9、9:16、3:4、4:3以及更多

安装

直接使用npx运行（推荐）：

npx artifex-mcp

或全局安装：

npm install -g artifex-mcp

认证

反重力（默认）

npx artifex-mcp --login

这将：

  1. 打开Google OAuth浏览器
  2. 将凭据安全地存储在 ~/.config/artifex-mcp/auth.json

开放人工智能

设置 OPENAI_API_KEY 环境变量：

export OPENAI_API_KEY=sk-...

用法

作为MCP服务器

添加到MCP客户端配置中：

克劳德桌面 (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 格式：

# Use Antigravity (default)
generate_image({ prompt: "a cat" })

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

# Use a specific Antigravity model
generate_image({ prompt: "a cat", model: "antigravity:gemini-3-pro-image" })

可用工具

generate_image

根据文本提示生成图像。

参数 类型 必填 默认 说明
prompt string 是 - 图像描述或编辑指令
model string 否 环境默认值 中的提供程序和模型 provider:model 格式
aspect_ratio enum 否 “1:1” 1:1、16:9、9:16、3:4、4:3、2:3、3:2、4:5、5:4、21:9
output_path string 否 cwd 保存图像的目录
file_name string 否 auto 自定义文件名
input_image string 否 - 编辑图像的路径（仅限反重力）
count number No 1 图像数量1-4（仅反重力）
session_id string 否 - 用于字符一致性（仅限反重力）

示例：

# Default provider (Antigravity)
Generate a cyberpunk cityscape at night

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

# Multiple images (Antigravity only)
Generate 4 variations of a majestic dragon, aspect ratio 16:9

# Character consistency (Antigravity only)
Create a hero named Luna, session_id: luna

auth_status

检查提供程序的身份验证状态。

参数 类型 必填 说明
provider string 否 要检查的提供程序（默认值：反重力）

auth_login

获取与提供商进行身份验证的说明。

auth_logout

删除提供程序的已存储凭据。

quota_status

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

供应商能力

特性 反重力 OpenAI
文本到图像 ✅ ✅
图像编辑 ✅ ❌
多张图片 ✅ (1-4) ❌ （仅1个）
会议 ✅ ❌
纵横比 ✅ ✅ （有限）
Auth类型 Google OAuth API密钥

文件位置

目的 地点
证书 ~/.config/artifex-mcp/auth.json
会议 ~/.cache/artifex-mcp/sessions/
生成的图像 当前工作目录（或自定义路径）

故障排除

“未验证”错误（反重力）

npx artifex-mcp --login

“找不到OpenAI API密钥”错误

设置环境变量：

export OPENAI_API_KEY=sk-...

请求频率超限

等待错误消息中指示的时间。每个账户都有利率限制。

不支持的功能错误

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

  • session_id 仅适用于反重力
  • input_image （编辑）仅适用于《反重力》
  • count > 1 仅适用于反重力

许可证

麻省理工学院

Legal

预期用途

  • 仅限个人/内部发展
  • 尊重配额和数据处理政策
  • 不用于生产服务或绕过预期限制

警告

通过使用此插件，您确认：

  • 服务条款风险 --这种方法可能违反AI模型提供者的ToS
  • 账户风险 --提供商可以暂停或禁止帐户
  • 没有保证 --API可能会更改，恕不另行通知
  • 风险承担 --您承担所有法律、财务和技术风险

免责声明

不隶属于谷歌或OpenAI。这是一个独立的开源项目。

“Antigravity”、“Gemini”、“Google Cloud”、“谷歌”、“OpenAI”和“DALL-E”是其各自所有者的商标。

相关 MCP