Artifex MCP

🚀 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 等多种宽高比。

📦 安装指南

推荐使用 npx 直接运行：

npx artifex-mcp

或者全局安装：

npm install -g artifex-mcp

📚 详细文档

身份验证

Antigravity（默认）

npx artifex-mcp --login

此命令将：

1. 打开浏览器进行 Google OAuth 认证。
2. 将凭证安全地存储在 ~/.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-..."
            }
        }
    }
}

环境变量

供应商选择

使用 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

根据文本提示生成图像。

示例：

# 默认供应商（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

检查供应商的认证状态。

auth_login

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

auth_logout

删除存储的供应商凭证。

quota_status

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

供应商功能

文件位置

故障排除

"未认证" 错误（Antigravity）

npx artifex-mcp --login

"未找到 OpenAI API 密钥" 错误

设置环境变量：

export OPENAI_API_KEY=sk-...

速率限制超出

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

不支持的功能错误

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

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

📄 许可证

本项目采用 MIT 许可证。

⚠️ 重要提示

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