InDesign MCP Server

adobe-mcp

Adobe アプリケーション向けの MCP サーバーです。1 つのアプリケーション用サーバーを単独でインストールすることも、スイートをインストールすることもできます。スイートには各アプリケーション用のサーバーが 1 つずつ含まれ、それらの間で動作するツールも備えています。

InDesign サーバーは、2.3.0 までは indesign-mcp-server として公開されていました。現在は adobe-mcp-indesign という名前になっており、ツールは同じです。クライアント設定のパッケージ名を置き換えてください。

パッケージ	操作対象	npm
adobe-mcp-indesign	Adobe InDesign：ドキュメント、ページ、テキスト、スタイル、表、ブック、PDF と EPUB の書き出し（423 個のツール）	adobe-mcp-indesign
adobe-mcp-illustrator	Adobe Illustrator：ドキュメント、アートボード、レイヤー、図形とパス、タイポグラフィ、カラーとスウォッチ、効果と 3D、シンボル、パターン、画像トレース、画像とリンク、変数とデータセット、アクション、書き出し、プリプレスと印刷（308 個のツール）	adobe-mcp-illustrator
adobe-mcp-photoshop	Adobe Photoshop：ドキュメントと形式、画像とカンバス、レイヤー、マスク、スマートオブジェクトとレイヤースタイル、選択範囲とチャンネル、調整レイヤーと塗りつぶしレイヤー、フィルター、ペイントとレタッチ、文字とパス、ビデオタイムライン、アクションとバッチ、アートボード、書き出し、印刷と環境設定（207 個のツール）	adobe-mcp-photoshop
adobe-mcp-aftereffects	Adobe After Effects：プロジェクトとフッテージ、コンポジション、レイヤーと時間、キーフレームとエクスプレッション、すべてのエフェクトとそのコントロール、テキストアニメーター、マスクとシェイプレイヤー、ペイントとロト、3D、トラッキング、カラー、レンダーキューとエッセンシャルグラフィックス（164 個のツール）	adobe-mcp-aftereffects
adobe-mcp-premiere	Adobe Premiere Pro：プロジェクトとビン、シーケンス、タイムライン編集、マーカー、エフェクト、キーフレームとトランジション、トランスクリプト、メタデータと書き出し（UXP プラグイン経由、96 個のツール。Premiere Pro でのテストはまだ実施されていません）	adobe-mcp-premiere
adobe-mcp-suite	InDesign、Illustrator、Photoshop、After Effects、Premiere Pro を 1 つのサーバーに統合（1,200 個のツール）。さらに、Illustrator のアートワークを InDesign のレイアウトに取り込むツールや、正確な値を使ったスウォッチなど、アプリケーション間で使えるツールも備えています	adobe-mcp-suite
adobe-mcp-core	共通基盤：スクリプトのエスケープ処理、スクリプトランナー、サーバーシェル、静的スクリプト監査	adobe-mcp-core

各サーバーは Adobe アプリケーションがインストールされているマシン上で実行され、アプリケーションに付属するスクリプトインターフェイスである ExtendScript を通じて通信します。Premiere Pro には外部からのスクリプト実行手段がないため、サーバーは代わりに Premiere Pro 内部の UXP プラグインと通信します。macOS と Windows に対応しています。

対応する ArtCraft アプリケーションもサポートしています。

• PhotoCraft（Photoshop 用。PHOTOCRAFT_CONTROL_PORT、デフォルトは 7878）
• VectorCraft（Illustrator 用。VECTORCRAFT_CONTROL_PORT、デフォルトは 7979）
• DesignCraft（InDesign 用。DESIGNCRAFT_CONTROL_PORT、デフォルトは 7979）
• EffectCraft（After Effects 用。EFFECTCRAFT_CONTROL_PORT、デフォルトは 9877）
• FilmCraft（Premiere Pro 用。FILMCRAFT_CONTROL_PORT、デフォルトは 9876）

ArtCraft アプリケーションの実行中、または TARGET=craft や <APP>_TARGET=craft（例：PHOTOSHOP_TARGET=craft、DESIGNCRAFT_TARGET=craft）で明示的に設定されている場合、対応するツールはループバックの JSON Lines 制御チャネルを介して ArtCraft に透過的にルーティングされます。

必要条件

• Node.js 18 以降（LTS 推奨）。npx は付属しています。
• 操作する Adobe アプリケーションを同じマシンにインストールしておきます： InDesign、Illustrator、Photoshop、After Effects 2023 以降、または UXP プラグインを読み込んだ Premiere Pro 25.6 以降（ packages/premiereを参照）。
• MCP クライアント（Claude Code、Warp、Cursor、Claude Desktop、または mcpServers ブロックを読み込むクライアント）。

サーバーは stdio 経由で MCP を使用します。プロセスはクライアントが起動します。ホスト型エンドポイントはなく、パッケージ自体に API キーは必要ありません。アプリケーションにアクセスするツール呼び出しでは、対象アプリをマシン上で開いておく（または起動可能な状態にしておく）必要があります。

npm からインストール

1 つのアプリケーション

Claude Code：

claude mcp add --scope user indesign -- npx -y adobe-mcp-indesign
claude mcp add --scope user illustrator -- npx -y adobe-mcp-illustrator
claude mcp add --scope user photoshop -- npx -y adobe-mcp-photoshop
claude mcp add --scope user aftereffects -- npx -y adobe-mcp-aftereffects
claude mcp add --scope user premiere -- npx -y adobe-mcp-premiere

mcpServers ブロックを読み込むクライアント：

{
  "mcpServers": {
    "indesign": { "command": "npx", "args": ["-y", "adobe-mcp-indesign"] },
    "illustrator": { "command": "npx", "args": ["-y", "adobe-mcp-illustrator"] },
    "photoshop": { "command": "npx", "args": ["-y", "adobe-mcp-photoshop"] },
    "aftereffects": { "command": "npx", "args": ["-y", "adobe-mcp-aftereffects"] },
    "premiere": { "command": "npx", "args": ["-y", "adobe-mcp-premiere"] }
  }
}

フルスイート

各アプリケーションのツール（indesign_…、illustrator_… などのプレフィックス付き）に加え、両方のアプリが読み込まれている場合はアプリケーション間ツールも利用できる、1 つのプロセスです：

claude mcp add --scope user adobe -- npx -y adobe-mcp-suite

{
  "mcpServers": {
    "adobe": {
      "command": "npx",
      "args": ["-y", "adobe-mcp-suite"]
    }
  }
}

グローバルインストール（PATH に adobe-mcp-suite を追加）も可能です：

npm install -g adobe-mcp-suite

Homebrew または curl

macOS または Linux では、Homebrew を使って同じスイートのリリースをインストールできます：

brew install --formula https://raw.githubusercontent.com/zachshallbetter/adobe-mcp/main/Formula/adobe-mcp-suite.rb

または、最新の npm リリースをグローバルにインストールするインストーラースクリプトを使用します：

curl -fsSL https://raw.githubusercontent.com/zachshallbetter/adobe-mcp/main/scripts/install.sh | sh

どちらの方法でも Node.js 18 以降が必要です。curl インストーラーは macOS と Linux のシェルに対応しています。Windows ユーザーは npm install -g adobe-mcp-suite を使用できます。

次に、npx の代わりにバイナリをクライアントに指定します：

{
  "mcpServers": {
    "adobe": {
      "command": "adobe-mcp-suite",
      "args": ["--apps", "indesign,illustrator"]
    }
  }
}

マーケットプレイスの掲載ページ：mcprush.com/zachshallbetter/adobe-mcp-suite。

各パッケージの README では、ツール、規約、アプリごとの設定について説明しています。

使い方

アプリケーションの選択（スイートのみ）

デフォルトでは、スイートはすべてのアプリを読み込みます。--apps または ADOBE_MCP_APPS（カンマ区切りの ID：indesign、illustrator、photoshop、 aftereffects、premiere）を使って、読み込むアプリを絞り込めます：

npx -y adobe-mcp-suite --apps indesign,illustrator
# equivalent
ADOBE_MCP_APPS=indesign,illustrator npx -y adobe-mcp-suite

クライアント設定：

{
  "mcpServers": {
    "adobe": {
      "command": "npx",
      "args": ["-y", "adobe-mcp-suite", "--apps", "indesign,illustrator"],
      "env": {
        "INDESIGN_ALLOWED_DIRS": "/Users/you/Work:/Users/you/Desktop",
        "ILLUSTRATOR_ALLOWED_DIRS": "/Users/you/Work:/Users/you/Desktop"
      }
    }
  }
}

Windows では、許可するディレクトリを : ではなく ; で区切ります。

モデルに表示される内容

• 単一アプリのサーバーでは、そのアプリのツールが元の名前で公開されます （例：create_text_frame、export_pdf）。
• スイートでは、すべてのツール名にアプリ名のプレフィックスが付きます（ indesign_create_text_frame、illustrator_create_rectangle など）。 すでにアプリ名を含む名前には、プレフィックスが 1 回だけ付きます（indesign_status）。
• アプリケーション間ツール（スイートで両方のアプリが読み込まれている場合）：
  • place_illustrator_artwork_in_indesign — アクティブな Illustrator ドキュメントのアートボードを InDesign ページに配置し、.ai ファイルにリンクします。
  • copy_swatches_illustrator_to_indesign — 正確なプロセスカラー／特色の値を保持して、カラーのスウォッチをコピーします。

MCP 設定を変更した後は、ツール一覧を更新するために再接続するか、新しいクライアントセッションを開始してください。

環境変数

よく使う設定項目（すべての項目については各パッケージの README を参照してください）：

変数	用途
ADOBE_MCP_APPS	スイートのみ：読み込むアプリ（indesign,illustrator,…）
INDESIGN_ALLOWED_DIRS	InDesign ツールが読み書きできる追加ディレクトリ
ILLUSTRATOR_ALLOWED_DIRS	Illustrator ツールが読み書きできる追加ディレクトリ
INDESIGN_APP_NAME / ILLUSTRATOR_APP_NAME	対象アプリケーション名の上書き
INDESIGN_SCRIPT_TIMEOUT_MS / ILLUSTRATOR_SCRIPT_TIMEOUT_MS	スクリプトごとのタイムアウト
PREMIERE_WS_PORT、BRIDGE_TOKEN、PREMIERE_ALLOWED_DIRS	Premiere UXP ブリッジ

MCP クライアントなしでの動作確認

このプロセスは MCP JSON-RPC を stdin から受け取るために待機します。--help の出力がある一般的な CLI ではありません。バイナリが起動してツール一覧を返すことを確認するには、stdio 経由で initialize リクエストに続いて tools/list を送信するか、パッケージのテストを実行します （テストでは Adobe アプリをスタブ化するため、インストールは不要です）：

npm test -w packages/suite

実際のレイアウトや作業を行うには、対象の Adobe アプリケーションをこのマシンで実行しておく必要があります。

このリポジトリからインストールして実行する

サーバーを開発するときや、公開前のモノレポ版を使いたいときに利用します。

git clone https://github.com/zachshallbetter/adobe-mcp.git
cd adobe-mcp
npm install

ソースからサーバーを実行します（stdio。クライアントの command に適しています）。

# suite (optionally limit apps)
node packages/suite/src/index.js --apps indesign,illustrator

# one application
node packages/indesign/src/index.js
node packages/illustrator/src/index.js

npx の代わりにモノレポのエントリーポイントをクライアントに指定します。

{
  "mcpServers": {
    "adobe": {
      "command": "node",
      "args": [
        "/absolute/path/to/adobe-mcp/packages/suite/src/index.js",
        "--apps",
        "indesign,illustrator"
      ]
    }
  }
}

リポジトリの構成

packages/
  core/          adobe-mcp-core           shared by every server
  indesign/      adobe-mcp-indesign
  illustrator/   adobe-mcp-illustrator
  photoshop/     adobe-mcp-photoshop
  aftereffects/  adobe-mcp-aftereffects
  premiere/      adobe-mcp-premiere       with its UXP plugin in uxp/plugin
  suite/         adobe-mcp-suite          every application in one server

各サーバーは adobe-mcp-core を通じてインフラストラクチャを共有しているため、エスケープ処理、パスのチェック、結果の処理、スクリプトランナーに関する修正は、すべてのサーバーに反映されます。アプリケーションごとに異なるものは、ツール、指示、スクリプトの実行方法など、各パッケージに含まれています。各アプリケーションのパッケージはモジュール（ツール、ハンドラー、指示、スクリプトランナー）をエクスポートし、そのモジュールを基に単体のサーバーとスイートの両方が構築されるため、ツールを一度書くだけで済みます。

開発

npm install      # installs every package and links them together
npm run check    # syntax check, every package
npm test         # every package's tests, including each server's static script audit

パッケージ単体のテストは、npm test -w packages/illustrator で実行します。静的監査では、スタブ化したアプリケーションに対して各ツールを実行し、生成された各スクリプトをアプリケーションのスクリプティングオブジェクトモデルと照合します。アプリケーションをインストールする必要はありません。

リリース方法と各パッケージのガイドについては、CONTRIBUTING.md を参照してください。アーキテクチャ、ツール作成に関するアプリケーションごとのルール、ケイパビリティアトラスに基づく作業計画と実装、現在の状況、学んだ教訓をまとめたハンドブック全体については、docs/handbook/ を参照してください。

ライセンス

MIT。各パッケージの LICENSE を参照してください。