imagic

imagic MCP サーバー

MCP サーバーを内蔵した初の写真編集ソフトです。

imagic は、AI による写真の選別、完全な非破壊編集機能、スタイル学習機能を備えた Windows および macOS 向けデスクトップ写真編集ソフトです。MCP（Model Context Protocol）サーバーはアプリに内蔵されているため、Claude Code、Claude Desktop、Cursor、Codex、GitHub Copilot、その他あらゆる MCP クライアントから、撮影データのスキャン、選別、好みのスタイルでの編集、採用写真の書き出しまで、パイプライン全体を実行できます。すべてお使いのマシン上でローカルに動作します。

このリポジトリは、そのサーバーのドキュメントとセットアップガイドです。サーバー本体は imagic デスクトップアプリに同梱されているため、ここに別途サーバーのソースコードはありません。

• ガイド全文：imagic.ink/mcp
• AI クライアントを使わないスクリプト実行：imagic.ink/automation
• ダウンロード：imagic.ink/desktop

エージェントでできること

接続すると、エージェントはアプリで手動操作するときと同じアクションを実行できます。たとえば、次のように指示できます。

• 「D:/Shoots/june-wedding をスキャンして選別し、残した写真とその理由を教えて。」
• 「採用写真を暖かみのある色調にして、D:/delivery に書き出して。」
• 「ゴールデンアワーに撮影した写真に、自分のフィルムプリセットを適用して。」
• 「撮影した写真全体を、私が編集するように仕上げて。」（スタイルの調整後）
• 「この結婚式の写真を5枚編集したので、残りもそれに合わせて。」
• 「やっぱり、クライアント用ギャラリーにはベストショットを60枚だけ残して。」（再分析なしで即座に再ランク付け）
• 「採用写真をフル解像度の JPEG として書き出して。」

編集内容は、手動編集と同じように imagic の編集履歴に非破壊調整として保存されます。明示的に書き出さない限り、オリジナルの写真が上書きされることはありません。

インストール

1. imagic.ink/desktop から imagic をダウンロードします。無料トライアルでは、imagic Max の全機能を利用して500回まで書き出せます。カードの登録は不要です（インポート、選別、編集は回数に含まれません）。
2. アプリを一度起動して、トライアルまたはライセンスを有効化します。MCP サーバーはその有効化情報を再利用します。
3. MCP クライアントを接続します（以下を参照）。

サーバーは --mcp を付けて起動する imagic アプリそのものです。パッケージ版アプリには pip パッケージも、別途実行する imagic-mcp コマンドもありません。クライアントからインストール済みのバイナリを指定してください。

• Windows：C:\Program Files\imagic\imagic.exe
• macOS：/Applications/imagic.app/Contents/MacOS/imagic

14種類のクライアントごとのセットアップ方法（設定ファイルの場所と、それぞれに適した設定キー）は、imagic.ink/mcp/setup をご覧ください。

Claude Code

claude mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

macOS の場合：

claude mcp add imagic -- /Applications/imagic.app/Contents/MacOS/imagic --mcp

Claude Desktop、Cursor、その他の JSON 設定を使うクライアント

クライアントの MCP 設定（Claude Desktop の場合は claude_desktop_config.json）に、次の内容を追加します。

{
  "mcpServers": {
    "imagic": {
      "command": "C:\Program Files\imagic\imagic.exe",
      "args": ["--mcp"]
    }
  }
}

macOS では、同じ "args": ["--mcp"] とともに "command": "/Applications/imagic.app/Contents/MacOS/imagic" を使用します。

Codex CLI

codex mcp add imagic -- "C:\Program Files\imagic\imagic.exe" --mcp

または、~/.codex/config.toml に次の内容を追加します。

[mcp_servers.imagic]
command = 'C:\Program Files\imagic\imagic.exe'
args = ["--mcp"]

GitHub Copilot など、その他の MCP 互換クライアントも同じ方法で動作します。コマンドに imagic バイナリと --mcp を指定した、ローカルの stdio サーバーとして接続します。

21 個のツール

ツール	機能	こう伝えます
scan_directory	RAW ファイルと JPEG ファイルが入ったフォルダーをライブラリにインデックスします。	"D:/Shoots/june-wedding をスキャンして、中身を教えてください。"
list_photos	ステータスで絞り込み、ページごとにスコア付きの写真を一覧表示します。	"この撮影で残した写真をすべて一覧表示してください。"
get_photo	1 枚の写真の詳細な記録、スコア、メタデータを取得します。	"_MG_2041.CR3 の分析結果はどうでしたか？"
get_library_stats	撮影ごとの枚数、採用率、選別の進捗を表示します。	"この撮影の選別はどこまで進んでいますか？"
analyze_photos	シャープネス、露出、ノイズ、構図、ディテールを評価します。重複写真や連写も検出します。	"すべてを評価して、残す写真にフラグを付けてください。"
set_photo_status	写真 1 枚の判定を「残す」「削除」または「未判定」に変更します。「削除」にしてもファイルは削除されません。	"12 番は残して、15 番は削除にしてください。"
reselect_photos	再分析せずに、残す写真を即座に再ランク付けします。上位 N 枚を選ぶポートフォリオモードです。	"やっぱり、上位 150 枚だけ残してください。"
check_score_freshness	保存済みスコアのうち、古い AI スコアラーによるものが何件あるかを報告します。	"スコアが古くなっている写真はありますか？"
reanalyze_stale_photos	古いスコアラーが評価した写真だけを再評価します。手動で選んだ写真には手を加えません。	"古いものを再評価してください。"
apply_adjustments	写真ごと、または一括で、露出、色、トリミングなどの調整を適用します。	"セレモニーの写真セットのシャドウを少し持ち上げてください。"
list_presets	imagic のインストール環境に保存されているすべてのプリセットをエージェント向けに一覧表示します。	"使えるプリセットは何がありますか？"
apply_preset	保存済みのプリセットを選択した写真に一括適用します。	"ゴールデンアワーの写真にフィルムプリセットを適用してください。"
get_photo_edits	写真に適用されている非破壊編集の履歴を取得します。	"このファイルには今、どんな編集が適用されていますか？"
start_style_calibration	ライブラリから最大 8 枚の写真を使って、ガイド付きのスタイル調整を開始します。	"私の編集方法を覚えてもらいましょう。"
record_style_calibration	調整中に、各写真への編集を保存します。	"この写真は完了です。今の選択を覚えておいてください。"
get_style_profile	スタイル調整で学習した内容を確認します。	"私の編集スタイルを説明してください。"
apply_my_style	自分ならどのように編集するかに合わせて、写真セットを編集します。	"撮影全体を私らしいスタイルで編集してください。"
learn_style_from_library	imagic でこれまでに編集したすべての写真を使って、プロファイルを学習させます。	"これまでに編集した写真すべてから、私のスタイルを学習してください。"
match_style_from_examples	撮影した写真から数枚を編集し、保存済みのプロファイルに触れずに、残りの写真もその仕上がりに合わせます。	"この結婚式の写真を 5 枚編集したので、残りも同じ仕上がりにしてください。"
export_photos	残す写真を指定した形式とサイズで一括エクスポートします。一括処理の途中で中断しても再開できます。	"残す写真をフル解像度の JPEG でエクスポートしてください。"
get_preview_url	エージェントの作業をリアルタイムで確認できる、ローカルのライブプレビュー画面へのリンクを表示します。	"何をしているか見せてください。"

スタイル学習：8枚から始め、すべての写真で学習する

imagic のスタイルツールを使えば、エージェントによる編集を、ありきたりなものではなく、自分らしいものにできます。

1. 8枚の写真から始めるガイド付きの設定。 start_style_calibration は、ご自身のライブラリから、さまざまな光や被写体を含むシナリオ写真を最大8枚選びます。imagic でお好みに合わせて編集し、record_style_calibration で各判断を保存すれば、数分で最初のプロファイルが完成します。
2. 実際の編集内容を読み取ります。 imagic で設定した露出、色、トリミングの値を、シナリオごとに記録し、あなただけのプロファイルに反映します。get_style_profile を使えば、いつでも確認できます。
3. その後、すべての写真で学習します。 好みが変わったらいつでもセッションを繰り返すか、過去に編集した写真のライブラリに対して learn_style_from_library を実行してください。imagic でこれまでに編集したすべての写真が、プロファイルの学習に使われます。その後、apply_my_style を使えば、今後の撮影写真を、まるでご自身が編集したように仕上げられます。

1回の撮影では、「5枚を編集して残りに合わせる」こともできます。数枚を手動で編集した後、match_style_from_examples を使うと、保存済みのプロファイルを変更せずに、残りの写真をその仕上がりに合わせられます。

できることには限界があります。学習に使うのは imagic で行った編集で、実際に設定した調整値を読み取ります。書き出した JPEG や Lightroom カタログから、スタイルを推測することはできません。

プライバシー

MCP サーバーは imagic と並んでローカルで動作し、ご自身のマシン上で AI クライアントと通信します。エージェントが送信するのはツール呼び出しと指示だけで、写真が外部にアップロードされることはありません。スキャン、評価、編集、書き出しはすべて、ご自身のハードウェア上で行われます。imagic を直接使う場合と同じです。

ライセンス

MCP サーバーとヘッドレス CLI は imagic Max（99 EUR、買い切り、サブスクリプションなし）に含まれます。imagic の有料プランは19 EURからです。Lite と Plus では完全な GUI を使用できますが、ヘッドレスや MCP による自動化は利用できません。無料トライアルでは Max のすべての機能を利用でき、500回の書き出しまで、MCP と CLI も含めて、クレジットカード不要でお試しいただけます。

ヘッドレスおよび MCP を使用するには、デスクトップライセンスの有効化が必要です。GUI を一度起動し、トライアルまたはライセンスキーで有効化すると、MCP サーバーはその有効化状態を再利用します。

リンク

• imagic.ink/mcp：MCP と CLI の詳しいガイド、クライアントごとの設定、FAQ
• imagic.ink/automation：3つの自動化方法（アプリ内の一括処理ツール、ヘッドレス CLI、MCP）
• imagic.ink/desktop：ダウンロードと無料トライアル

---

imagic はクローズドソースの商用アプリケーションです。このドキュメントの著作権は imagic に帰属します（c）。MCP ディレクトリやレジストリを含め、自由に参照・リンクしていただけます。