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这将：
- 打开Google OAuth浏览器
- 将凭据安全地存储在
~/.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: lunaauth_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”是其各自所有者的商标。
