claude-foundry-image

Claude Codeプラグインで、すべてのプロジェクトとすべての会話に、独自のAzure AI Foundryデプロイメント（MAI画像API、例：MAI-Image-2.5-Pro）をバックエンドとする画像生成機能を提供します。

• MCPサーバー（server/server.mjs）— Node ≥ 18、依存関係ゼロ。ツール：generate_image、edit_image、check_config。

• スキルgenerate-image — Claudeにツールを使用するタイミング、ワンライナーを実用的なプロンプトに拡張する方法、有効な寸法、ファイルの書き込み先を教えます。

• スキルsetup — 一度だけの設定ウォークスルー。

画像はディスクに書き込まれ、ファイルパスのみが会話に入ります。コンテキスト内にbase64はありません。

Install

claude plugin marketplace add jpaarhuis/claude-foundry-image

claude plugin install foundry-image@jpaarhuis

またはインタラクティブセッションで：/plugin → マーケットプレイス → jpaarhuis/claude-foundry-imageを追加 → foundry-imageをインストール。

Related MCP server: gpt-image-mcp

Configure (once)

サーバーは環境変数から設定を読み取ります。~/.claude/settings.jsonのenvの下に設定を配置します — 1つのファイル、すべてのプラットフォーム、Claude Codeのみが参照します：

{
  "env": {
    "MAI_IMAGE_ENDPOINT": "https://<resource>.services.ai.azure.com/mai/v1/images/generations",
    "MAI_IMAGE_DEPLOYMENT": "MAI-Image-2.5-Pro",
    "MAI_IMAGE_API_KEY": "<key>",
    "MAI_IMAGE_OUTPUT_DIR": "C:/Users/<you>/Pictures/ai"
  }
}

または、OSのユーザー環境変数として設定します（Windowsではsetx、macOS/Linuxではシェルプロファイルでexport）。どちらの場合もClaude Codeを再起動します。

その後、任意のセッションで："run check_config" または /foundry-image:setup でガイド付きパスを実行します。

Use

ただ尋ねるだけ："README用のヒーロー画像を作って、暗めで、アイソメトリック、テキストなし"。Claudeがプロンプトを拡張し、寸法を選び、PNGを書き込み（リポジトリに属する場合はそこに）、パスを返します。

参考のためのツールパラメータ：

MAI APIの寸法ルール：各辺が768px以上、かつ幅×高さが1,048,576px以下。したがって1024x1024、1024x768、1280x800は動作しますが、1024x1536と1920x1080は動作しません。

Why env vars and not a config file or setup dialog?

Claude Codeプラグインにはプラグインごとのシークレットストレージや設定UIはありません。公式のGitHubプラグインがPATに使用しているのと同じ慣例は、プラグインの.mcp.json内での${VAR}展開であり、ユーザーが一度変数を設定します。settings.json → envはそのための最も摩擦の少ない場所です：Claude Codeプロファイルとともに移動し、すべてのプロジェクトに適用され、プラグインのアップデート後も維持されます。

キーをプレーンテキストファイルから除外したい場合は、ログイン時にシークレットストア（Key Vault、1Password CLI、Windows Credential Manager）から環境に読み込みます — サーバーは変数の出所を気にしません。

Develop

npm test

オフラインのスモークテストを実行します：MCPハンドシェイク、ツール一覧、寸法ガード、設定欠落エラー、およびcheck_configがキーを漏洩しないことを確認します。

License

MIT