editmamei-photoshop-mcp

Editmamei

自然言語で写真を編集し、Photoshop の機能を引き出します。 生成ではなく、AI によるオーケストレーションです。

Adobe Inc.とは無関係であり、同社からの承認も受けていない独立したプロジェクトです。

Editmamei は、デスクトップ版 Adobe Photoshop を操作する Model Context Protocol（MCP）サーバーです。編集内容を普段の言葉で説明すると、AI アシスタントが手順を立て、Photoshop が標準の調整レイヤー、マスク、選択範囲、フィルターを使って実行します。AI が指示し、Photoshop が編集します。生成モデルがピクセルに触れることはなく、編集のために画像がアップロードされることもありません。

会話しながら編集したい写真家やレタッチャーにも、AI パイプラインに Photoshop を組み込みたい開発者にも役立ちます。詳しい情報や利用開始方法は、editmamei.com をご覧ください。

editmamei.com · ドキュメント · バグを報告

_{実際の実行例：73枚の旅行写真を、1文の指示でPhotoshopでカラー調整。}

仕組み

Editmamei は、Node で記述された純粋な MCP stdio サーバーです。AI クライアントがサブプロセスとして起動し、stdio 経由でツールを呼び出します。各ツールは小さな Photoshop スクリプトを作成し、プラットフォーム固有のネイティブな自動化チャネルを使ってローカルの Photoshop で実行します。

AI client  ──stdio──▶  Editmamei (Node MCP server)
                              │  builds a Photoshop script per tool call
                              ▼
                    COM (Windows) / AppleScript (macOS)
                              │
                              ▼
                     Your local Adobe Photoshop

• Windows では、COM（Photoshop.Application オブジェクト）経由で Photoshop を操作します。
• macOS では、AppleScript / OSA 経由で操作します。
• 知覚（顔、物体、シーンの検出）は、ローカルの ONNX コンピュータービジョンを使ってデバイス上で実行されるため、画像をマシンの外に出すことなく、モデルに実際のドキュメント座標を渡せます。

ピクセルの処理は Photoshop 自身のエンジンが行います。Editmamei は指揮者であり、レンダラーではありません。

インストール

npm install -g editmamei
editmamei install   # registers with Claude Desktop, Cursor, Claude Code
editmamei status    # confirms install state + Photoshop detection

その後、AI クライアントを再起動して、「Photoshop は接続されていますか？」と尋ねてください。

ターミナルを使いたくない場合は、Claude Desktop ユーザーはワンクリックの .mcpb 拡張機能を直接インストールできます（システムに Node は不要です。Claude Desktop には独自のランタイムが同梱されています）。詳しい手順はインストールガイドをご覧ください。

必要条件： Adobe Photoshop 2026（v27.x）、Windows 10/11 または macOS 13 以降、Node.js 22 以降（npm 経由の場合）、MCP 対応 AI クライアント（Claude Desktop、Cursor、Claude Code）。Editmamei 自体にはモデルが含まれておらず、接続先のクライアント上で動作するため、編集のたびにそのクライアントのトークンを消費します。

セッションの流れ

検出の流れは、ps_ping（稼働確認）、次に ps_overview（作業方法と機能の概要）、その後 tools/list（スキーマで型付けされたツールの全一覧）です。その後は、アシスタントに話しかけるだけです。

「休暇中に撮った写真を開いて。」 「空をもっとドラマチックにして、前景は自然なままにして。」 「目をシャープにして、肌をなめらかにし、それ以外は何も変えないで。」 「被写体をきれいなマスク付きで独立したレイヤーにして。」 「2048px のウェブ用 JPEG で書き出して。」

アシスタントはこれらの指示をツール呼び出しに組み立て、プレビューや測定値で結果を確認しながら、繰り返し調整します。

設計原則

これらはインターフェースを形作る選択であり、AI アシスタントが希望的観測ではなく、確実に操作できる理由でもあります。

• 文章ではなく、構造化された結果。 すべてのツールは outputSchema を宣言し、型付きの JSON ペイロードを返します。アクティブな対象を変更するツールは、現在のドキュメントとレイヤーを返すため、モデルは呼び出しのたびに状態を推測し直すことなく、Photoshop の状態を正確に把握できます。
• ガイダンスをインターフェースに組み込む。 ps_overview は作業方法（評価、計画、実行、確認、反復）を返し、ps_list_capabilities は利用可能な機能の最新マップを返します。モデルは推測や古いプロンプトに頼らず、サーバーから状況を把握します。
• 目測ではなく、測定する。 専用の検証ツール一式（ヒストグラム、領域比較、レイヤー境界の差分、選択範囲のプレビュー）を使うことで、サムネイルを信頼するのではなく、自身の作業を数値で確認できます。
• デバイス上での認識。 ローカルのコンピュータービジョン（ONNX）が顔、オブジェクト、シーン領域を検出し、実際のドキュメント座標を返します。この処理では画像はお使いのマシン上にとどまり、クラウドのビジョンモデルに送信されることはありません。
• デフォルトで非破壊。 調整には調整レイヤーを使い、破壊的なピクセル操作は自動作成された複製に対して実行します。編集は仕組み上、元に戻せます。
• 実際の Photoshop で検証済み。 すべてのツールは Photoshop 独自のネイティブスクリプト関数を基盤として構築され、リリース前に実際の Photoshop セッションで検証されています。新しいツールは実環境での検証に合格するまで無効のままなので、リリースされる機能はすべて検証済みです。
• 最新の Photoshop 向けに構築。 Editmamei は Photoshop 2026（v27.x）を対象としており、10 年分のずれた挙動を抱え続けることなく、最新かつ安定したスクリプト記述子を利用できます。

ツールの種類

ツールは合計112個です。 Photoshopのツール群は16の機能グループにまたがる83個のツール（Community 62個、Pro 21個）で構成されており、Photoshopの機能ごとに1つのツールを用意するのではなく、作業内容ごとにグループ化されています。すべてのツールに ps_* 名前空間が割り当てられており、実行時に tools/list から検出できます。Communityツールは両エディションに含まれ、Proツールはライセンスによって利用可能になります。これに加えて、ヘッドレスGIMPを操作する独立した2つ目のエディター用ツール群があります。Communityの gimp_* ツール29個が現在ベータ版で利用できます。詳しくは、以下のGIMP（ベータ版）をご覧ください。Proの追加機能はPhotoshop専用で、GIMPにはProエディションがありません。

グループ	エディション	ツール
コア	Community	ping · overview · list_capabilities · undo · redo · report_problem
検査	Community	inspect · get_preview
検証	Community	get_histogram · compare_regions · get_layer_bounds_diff · get_selection_preview
ドキュメントとキャンバス	Community	document · create_document · open_document · close_document · save_psd · export · place_image · resize_image · crop_document · convert_image_mode · transform_canvas · guides
選択範囲	Community	select · modify_selection · selection_channel
調整	Community	add_adjustment_layer · apply_adjustment
フィルター	Community	filter
レタッチ	Community	retouch
レイヤー	Community	create_layer · delete_layer · fill_layer · add_fill_layer · select_layer · move_layer_to_position · duplicate_layer · copy_to_new_layer · convert_to_smart_object · rasterize_layer · set_layer · merge · bake_layer · add_layer_style · transform_layer · shape · group
マスクとパス	Community	layer_mask · clipping_mask · path · vector_mask · apply_image · calculations
文字	Community	text
画像認識	Community	detect · read_scene · select_by_reference
AI選択	Community	select_subject · select_sky · replace_sky
自動化	Community	sequence
AI選択	Pro	select_subject_instance · select_object
フィルター	Pro	apply_camera_raw · develop_raw
レイヤー（ワープ）	Pro	warp_layer
画像認識	Pro	edit_object · add_text_to_object · resolve_placement
顔メッシュ	Pro	detect_landmarks · select_face_feature
テンプレート	Pro	template_create_evidence · template_save · template_list · template_apply · template_verify · template_recall · template_delete
自動化	Pro	list_actions · play_action · execute_script · batch

GIMP（ベータ版）、独立した名前空間、すべてCommunity：

グループ	エディション	ツール
GIMP	Community（ベータ版）	gimp_ping · gimp_overview · gimp_open_document · gimp_close_document · gimp_save_xcf · gimp_export · gimp_inspect · gimp_add_adjustment · gimp_add_effect · gimp_filter · gimp_bake · gimp_layer · gimp_transform_layer · gimp_text · gimp_select · gimp_modify_selection · gimp_layer_mask · gimp_get_selection_preview · gimp_create_document · gimp_place_image · gimp_canvas · gimp_convert_image_mode · gimp_crop_document · gimp_resize_image · gimp_transform_canvas · gimp_checkpoint · gimp_get_preview · gimp_get_histogram · gimp_compare

エディション

• Community は無料で、日常的な編集機能をカバーします。ドキュメント、レイヤー、選択範囲（AI による被写体選択と空の選択を含む）、非破壊調整、フィルター、マスク、文字、レタッチ、デバイス上での認識、検査・検証の基本機能を利用できます。
• Pro では、再編集可能なフィルターとしての Camera Raw、開く前に現像する RAW ファイル、フォルダーの一括処理、再現可能なテンプレートシステム、精密なグラウンディングツール（ワープ、名前付きオブジェクトマスク、精密な配置）、被写体のインスタンスと顔メッシュのターゲティング、Photoshop アクション、およびスクリプトによる拡張機能が追加されます。

Pro は Photoshop 専用のアップグレードで、以下の GIMP 機能には何も追加されません。

詳細な違いは pro-features.md をご覧ください。価格については editmamei.com をご確認ください。

このリポジトリには Community のソースが含まれています。Pro は別途ライセンスされるモジュールで、ソースはここでは公開されていません。Community が Pro をインポートすることはないため、このツリーだけでビルドして実行できます。

GIMP（ベータ版）

Editmamei は Photoshop と並行して、または Photoshop の代わりに、ヘッドレスで GIMP を操作することもできます。お使いのマシンで GIMP 3.2+ が検出されると、ps_* ツールの隣に gimp_* ツールセットが登録されます。GIMP を使うよう依頼された場合や、Photoshop が利用できない場合に使用してください。画面にウィンドウは表示されません。編集はバックグラウンドの gimp-console プロセスで行われ、ウィンドウの変化を見る代わりに、会話内にレンダリングされるプレビューで進行状況を確認できます。

ベータ版では、ドキュメント（開く、新規作成、.xcf 形式で保存、書き出し）、レイヤーとグループ、写真を別の写真に配置する機能、13 種類の非破壊調整と 6 種類の効果（ビネット、白黒、モーションブラー、レンズぼかし、ノイズ、ドロップシャドウ）、レイヤーマスクとして適用できる選択範囲（図形、色域、マジックワンド、グラデーション）、ライブテキストレイヤー、レイヤーの移動・拡大縮小・回転、切り抜き・サイズ変更・回転・反転、キャンバスの拡張、カラー／グレースケール変換、復元可能なチェックポイント、Photoshop 側と同じプレビュー・ヒストグラム・比較検証の基本機能を利用できます。修復／クローンや、AI による被写体と空の選択には、まだ対応していません。詳細、要件、トラブルシューティングについては、docs/gimp.md をご覧ください。

ソースからビルド

git clone https://github.com/editmamei/editmamei.git
cd editmamei
npm install
npm run build
npm test

Node.js 22+ と Go 1.21+ が必要です（ビルドでは Photoshop スクリプトを生成する editmamei-core バイナリをコンパイルします。このバイナリには Go 1.27 が必要ですが、Go が 1.21 以降から自動的に取得します）。Go がない場合、ビルドは失敗せずに警告を表示するため、テストスイートは引き続き実行できます。Go をインストールしない場合は、EDITMAMEI_CORE_BIN にビルド済みバイナリを指定してください。

テストスイートは Photoshop なしで実行できます。検証するのは Editmamei が生成する ExtendScript であり、Photoshop がそれを受け入れたかどうかではありません。そのため、実際の Photoshop を使ったライブ検証は別途必要です。

コントリビューションを歓迎します。CONTRIBUTING.md から始めてください。CLA、ブランチとプルリクエストの手順、バグ報告に含める内容について説明しています。

設定

設定は ~/.editmamei/settings.json に保存され、editmamei config CLI で管理します。

editmamei config list
editmamei config set telemetry.usage false      # turn off usage telemetry
editmamei config set ps_path "/path/to/Photoshop"

環境変数の PHOTOSHOP_PATH を設定すると、1 回の実行に限り Photoshop の自動検出を上書きできます。

プライバシー

Editmamei はお使いのコンピューター上で動作し、デスクトップ版 Photoshop で編集します。画像の内容、ドキュメントデータ、ファイルパスが Editmamei のサーバーに送信されることはありません。コンテンツを含まない利用状況テレメトリーを報告します（デフォルトで有効です。editmamei config set telemetry.usage false で無効にできます）。AI アシスタントが結果を見る必要がある場合、Editmamei はそのアシスタントとのチャットに写真を貼り付けるときと同じように、縮小したプレビューを送信します。プライバシーに関するドキュメントには、お客様の権利と法的根拠を含め、各項目が記載されています。

このリポジトリのソースは npm で公開されているコードと同一なので、これらの説明を無条件に信じる必要はありません。

ドキュメントとサポート

• 機能と料金： editmamei.com
• インストール： docs/installation.md
• はじめに： docs/getting-started.md
• よくある質問： docs/faq.md
• AI クライアント： docs/clients.md
• トラブルシューティング： docs/troubleshooting.md
• GIMP（ベータ版）： docs/gimp.md
• Pro の機能： docs/pro-features.md
• ロードマップ： docs/roadmap.md
• バグと機能リクエスト： 課題トラッカー。何かが正常に動作しない場合は、アシスタントに「問題を報告」と依頼するか、editmamei report を実行して、匿名化された診断情報を含むファイルをダウンロードフォルダーに作成し、それを課題に添付してください。
• セキュリティ： SECURITY.md を参照してください（セキュリティの問題を公開で報告しないでください）。

ライセンス

Editmamei CE は Fair Source ソフトウェアであり、 Functional Source License, v1.1, MIT Future License（FSL-1.1-MIT）の下で提供されています。

コードは、商用の写真編集、社内ツール、教育、研究、セキュリティレビューなど、ほぼあらゆる用途で、閲覧、実行、変更、再配布できます。ライセンスで制限されるのは、各リリースから 2 年間、Editmamei CE または Pro と競合する商用製品やサービスにおいて、コードを他者に提供することです。コードを再配布する場合は、ライセンスと著作権表示を保持してください。各バージョンのリリースから 2 年後、そのバージョンは自動的に通常の MIT ライセンスで利用可能になります。

このセクションは、平易な言葉でまとめた概要です。LICENSE ファイルがライセンスの正式な内容であり、ここに記載した内容と異なる場合は LICENSE ファイルが優先されます。

Editmamei は OSI の定義におけるオープンソースではなく、そのようには呼んでいません。ソースコードは公開されており、CE のスタック全体をオープンに開発しています。

Editmamei Pro は別個の商用ライセンスモジュールであり、ソースコードは公開されていません。

サードパーティの依存関係にはそれぞれ独自のライセンスがあり、NOTICES.md に記載されています。