Ezkielyna Image

Ezkielyna Image MCP

AI アシスタント（Claude Desktop、Claude Code、Cursor、OpenCode、またはローカルの stdio サーバーを実行するその他の MCP クライアント）から、コンピューター上のファイルを使って画像を作成・編集できる MCP サーバーです。画像は Ezkielyna API を通じて生成されます。

例：「商品写真は ~/Shop/mug.jpg、ロゴは ~/Shop/logo.png です。ロゴをマグカップに載せて、mug-logo という名前で保存してください。」

🇮🇩 インドネシア語：以下のセクションをご覧ください。

• ファイルは1つ、依存関係なし：Node.js 18 以降のみが必要です。npm install は不要です。
• 参照画像にはローカルファイル（または https リンク）を使用し、結果はローカルに保存されます。
• 結果は再編集できます。アシスタントは前回の結果のパスを渡すだけです。
• 有料の呼び出し回数はセッションごとに制限され、API キーが表示されることはありません。また、既存のファイルが上書きされることもありません。

npm： ezkielyna-image-mcp。アプリから npx -y ezkielyna-image-mcp で起動できるため、クローンは不要です。公式 MCP レジストリでは io.github.EzkielynaGroup/ezkielyna-image-mcp として登録されています。

要件

1. Node.js 18 以降（node -v）。nodejs.org から LTS 版を入手してください。
2. Media グループの Ezkielyna API キー（Auto グループにも画像モデルが含まれています）。ezkielyna.store で API クレジットを購入し（$0.5 から、QRIS/DANA/GoPay/USDT 対応）、api.ezkielyna.store の Wallet で引き換えた後、API Keys でキーを作成してください。Standard/Premium キーは画像モデルを使用できません。
3. ある程度の残高。画像ごとの料金は list_image_models ツールと ezkielyna.store/models に表示されます。

インストール

npx を使用（推奨）： インストールは不要です。以下の設定では npx -y ezkielyna-image-mcp を実行し、初回起動時にパッケージ（依存関係のない1ファイル）をダウンロードします。

ソースからインストール（コードを確認または変更する場合）：

git clone https://github.com/EzkielynaGroup/ezkielyna-image-mcp.git
cd ezkielyna-image-mcp
node --test test/        # optional: runs against a local mock, no network, no cost
pwd                      # the full path of ezkielyna-image-mcp.mjs is <this folder>/ezkielyna-image-mcp.mjs

Windows でアプリから npx を起動できない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "ezkielyna-image-mcp"] を使用してください。ソースからインストールする場合、JSON のパスにはスラッシュ（C:/Users/you/ezkielyna-image-mcp/ezkielyna-image-mcp.mjs）を使うか、バックスラッシュを2つ重ねてください。

設定（環境変数）

変数	必須	デフォルト	備考
EZKIELYNA_API_KEY	はい		Media（または Auto）グループのキー
EZKIELYNA_BASE_URL	いいえ	https://api.ezkielyna.store/v1	API アドレス
EZKIELYNA_IMAGE_DIR	いいえ	~/Pictures/Ezkielyna	出力フォルダー（存在しない場合は作成）
EZKIELYNA_MAX_IMAGES	いいえ	30	セッションあたりの有料画像数。ループの暴走を防ぐための上限です。リセットするにはアプリを再起動してください。
EZKIELYNA_TIMEOUT_MS	いいえ	300000	リクエストのタイムアウト

アプリに追加する

sk-... を Media キーに置き換えてください。ソースからインストールした場合は、npx の代わりに "command": "node" と "args": ["/path/to/ezkielyna-image-mcp.mjs"] を使用してください。

Claude Desktop：設定 → 開発者 → 設定ファイルを編集（claude_desktop_config.json）を選択し、Claude Desktop を完全に終了してから再起動してください。

{
  "mcpServers": {
    "ezkielyna-image": {
      "command": "npx",
      "args": ["-y", "ezkielyna-image-mcp"],
      "env": { "EZKIELYNA_API_KEY": "sk-..." }
    }
  }
}

Claude Code

claude mcp add ezkielyna-image -e EZKIELYNA_API_KEY=sk-... -- npx -y ezkielyna-image-mcp

すべてのプロジェクトで利用できるようにするには、--scope user を追加してください。claude mcp list で確認できます。

Cursor：~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に、Claude Desktop と同じ JSON を設定します。

OpenCode：プロジェクト内の opencode.json、またはすべてのプロジェクトで使用する場合は ~/.config/opencode/opencode.json を設定します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ezkielyna-image": {
      "type": "local",
      "command": ["npx", "-y", "ezkielyna-image-mcp"],
      "enabled": true,
      "environment": { "EZKIELYNA_API_KEY": "sk-..." }
    }
  }
}

ツール

ツール	機能	料金
generate_image	テキストから新しい画像を生成します。オプション：model（デフォルトはgpt-image-2.5）、size（例：1024x1024）、filename。	画像ごと
edit_image	1～4枚の画像（ローカルパスまたはhttpsリンク）を編集または合成します。オプション：model、quality（gpt-imageのみ）、size、filename。	画像ごと
list_image_models	ご利用のキーで使用できる画像モデル、画像ごとの料金、編集に対応しているモデルを表示します。	無料

編集モデル：gpt-image-2.5（デフォルト、最大4枚の参照画像に対応。ロゴや背景に適しています）およびnano-banana-pro（最大4枚の参照画像に対応。高精細で、料金は高めです）。アップロードの合計サイズは約30 MB未満にしてください（nano-banana-proでは、base64として送信されるため約22 MB未満です）。大きなスマートフォン写真は、あらかじめ約2000 pxのJPEGにリサイズしてください。

各結果にはファイルパス、モデル、料金が含まれ、画像サイズが3.5 MB以下の場合は画像がインラインで表示されます。

セキュリティ

• 内容が実際に画像である20 MB以下の.png、.jpg、.jpeg、.webpファイルのみを読み込みます。リンクはhttpsである必要があります。
• 出力フォルダー内にのみ書き込みます。ファイル名をサニタイズし、上書きはしません（name-1.png、name-2.png、…）。
• すべての回答とログ行からキーを除去します。ログはstderrに出力され、stdoutにはMCPメッセージのみが出力されます。
• EZKIELYNA_MAX_IMAGESでセッションあたりの有料呼び出し数を制限できます。

その他のプロバイダー

このサーバーはEzkielyna API向けに構築されています。EZKIELYNA_BASE_URLを、/v1/images/generationsと/v1/images/editsを通じて同じ画像モデル名を提供する、別のOpenAI互換エンドポイントに設定できます。ただし、そこでは画像ごとの料金は表示されません。

開発

node --test test/

テストでは、ローカルのモックゲートウェイに対してstdio経由でサーバーを起動します。インターネット接続も費用も不要です。Issueやプルリクエストを歓迎します。

---

インドネシア語

コンピューター上のファイルから画像を作成・編集するためのMCPサーバーです。AIアシスタント（Claude Desktop、Claude Code、Cursor、OpenCode）を通じて利用できます。例：「~/Toko/logo.pngのロゴを~/Toko/kaos.jpgの左胸に貼り付けて、kaos-logoとして保存してください。」

• **Node.js 18+**だけで利用できます。npmで提供されており、アプリからnpx -y ezkielyna-image-mcpを実行すれば使えます。クローンは不要です。ソースから実行することもできます（git clone、上記を参照）。
• Ezkielyna APIのMediaグループのAPIキー（またはAuto）が必要です。QRIS／DANA／GoPayで$0.5からチャージできます：ezkielyna.store/beli-api-key。
• 各アプリの設定は上記の例と同じです。sk-...を置き換えるだけです。
• インドネシア語の詳しいガイド：ezkielyna.store/panduan/mcp-gambar。

ライセンス

MIT。Ezkielynaは独立したAPIゲートウェイであり、モデルの提供元やMCPクライアントの開発元とは提携していません。