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 沒有關聯、未得到其認可或支持。使用時請自行承擔風險。