Artifex MCP

🚀 Artifex MCP

Artifex MCPは、複数のプロバイダをサポートするAI画像生成用のMCP（Model Context Protocol）サーバーです。これにより、テキストから画像を生成したり、既存の画像を編集したりすることができます。

🚀 クイックスタート

このサーバーは、複数のAI画像生成プロバイダをサポートしています。以下の手順でセットアップして使用を開始できます。

✨ 主な機能

• 複数プロバイダサポート：簡単なパラメータでAntigravityとOpenAIを切り替えることができます。
• テキストから画像生成：テキストの説明から画像を生成します。
• 画像編集：テキスト指示で既存の画像を編集します（Antigravityのみ）。
• 複数出力：1回のリクエストで最大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

プロバイダのレート制限とクォータステータスを確認します。

プロバイダの機能

ファイルの場所

トラブルシューティング

"Not authenticated"エラー（Antigravity）

npx artifex-mcp --login

"OpenAI API key not found"エラー

環境変数を設定します。

export OPENAI_API_KEY=sk-...

レート制限超過

エラーメッセージに表示される時間待ちます。レート制限はアカウントごとに適用されます。

サポートされていない機能エラー

一部の機能は特定のプロバイダでのみ利用可能です。例えば：

• session_idはAntigravityでのみ機能します。
• input_image（編集）はAntigravityでのみ機能します。
• count > 1はAntigravityでのみ機能します。

📄 ライセンス

MIT

⚠️ 重要提示

このツールは非公式のものです。GoogleまたはOpenAIとは関係がなく、これらの会社によって承認またはサポートされていません。自己責任で使用してください。