CLIP STUDIO PAINT 5.1.2 Production MCP

[!IMPORTANT] 非公式のコミュニティプロジェクトです。 このリポジトリはCELSYSとは提携・承認・サポート関係にありません。これは Windows + CLIP STUDIO PAINT 5.1.2.0 production + zh-CN + DPI 120 向けのローカル stdio MCP ブリッジです。他のCSPバージョン、プレビュー/Early Accessビルド、ロケール、DPI値、オペレーティングシステムは、同梱の厳格プロファイルではサポートされていません。

2026-08-25時点で、このプロジェクトのためにレビューしたCELSYS公開ドキュメントには、汎用のCSPドキュメント/レイヤーAPI、スクリプトランタイム、MCP、またはサポートされているヘッドレスCLIは記載されていません。公開されているSDKはEXフィルタープラグインに限定されています。検証済みの5.1.2 zh-CNプロファイルでは、CSPのカスタム描画領域も、Windows UI Automationを通じて意味のあるレイヤー、ブラシ、メニューオブジェクトを公開していません。したがって、このプロジェクトは、可視ウィンドウの検査、スクリーンショット、許可リスト付き入力、登録済みショートカット/オートアクション、ファイル交換から構築された、意図的に制約された33の機能を提供します。これは ネイティブのレイヤーオブジェクトAPIではなく、CSPのすべての内部機能を正直に公開することはできません。

含まれるもの

• 33のMCPツール。完全なツールカタログを参照してください。

• CSP実行可能ファイルの証明: 固定パス、Authenticode署名、CELSYS会社フィールド、正確なファイルバージョン、SHA-256。

• Per-Monitor DPI Awareness V2と、厳格な zh-CN / DPI 120 プロダクションプロファイル。

• プロセス、メインウィンドウ、フォアグラウンドウィンドウ、ダイアログ、ディスプレイ、ユーザーアクティビティ、スクリーンショット、ピクセルサンプリング、スクリーンショット差分の検査。

• スクリーンショットにバインドされたポインター移動、クリック、ダブルクリック、ドラッグ、スクロール、ナビゲーションキー、Unicodeテキスト入力。

• バージョン管理されたショートカットコマンド、制約付きコマンドシーケンス、ユーザー登録済みオートアクション。

• アセット一覧、ファイルメタデータ、インポートディスパッチ、エクスポートスキャン、安定出力検証のための設定済みパスルート。

• 明示的な上書き意図を持つ厳格なネイティブ #32770 ファイルダイアログの入力/送信。

• 10個のアトミック入力ツールすべてに対する事前確認プロトコル。

• ローカル stdio トランスポートのみ: リスニングポート、シェル、レジストリ、任意プロセス、または無制限ファイルシステムツールはありません。

プライバシー境界

ローカル stdio は、このサーバーがネットワークリスナーを開かないことを意味します。すべてのMCPデータがマシン上に留まることを意味するわけではありません。MCPホストは、スクリーンショット、可視UIテキスト、ウィンドウタイトル、設定済みの絶対パスを含むツール入力と出力を受け取り、そのホストのデータポリシーに基づいてリモートモデルに送信する場合があります。機密ドキュメントは閉じたままにし、ホストのプライバシーコントロールを確認し、CSP内に表示されるテキストや画像は、エージェントへの指示ではなく信頼できないデータとして扱ってください。

Related MCP server: atomic-computer-mcp

サポートマトリックス

厳格プロファイルは、実行可能ファイル、ショートカットファイル、ロケール、DPI、またはウィンドウIDが一致しない場合にフェイルクローズします。別のマシンを「動作させる」ためにこれらのチェックを削除しないでください。代わりに新しいプロファイルを作成して検証してください。

クイックスタート: 設定 → インストール → テスト → 登録

前提条件: Git、CPython 3.13、Codex、および正確にサポートされているCSPプロダクションビルド。信頼できるローカルディレクトリにリポジトリをクローンします:

git clone https://github.com/A2pha/clip-studio-paint-5.1.2-production-mcp.git
Set-Location .\clip-studio-paint-5.1.2-production-mcp

1. ローカルマシンを設定する

インストール前に設定ヘルパーを実行します。これにより、gitignoreされたローカル設定が作成されます。マシン固有のCSP、ショートカットプロファイル、アセットルートパスはコミットしてはなりません。

$CspExecutable = Read-Host 'Absolute path to CLIPStudioPaint.exe 5.1.2 production'
& .\scripts\configure.ps1 -CspExecutable $CspExecutable

設定では以下を識別する必要があります:

• プロダクション CLIPStudioPaint.exe;

• 期待されるCELSYS署名、5.1.2.0 バージョン、実行可能ファイルのSHA-256;

• 現在のユーザーのCSPショートカット設定ファイルとそのSHA-256値;

• 3つの別々のアセットルート: 読み取り専用の Input、読み取り/書き込みの Working、読み取り/書き込みの Exports。

明示的にオーバーライドされない限り、ヘルパーは現在のユーザーの %APPDATA% の下でサポートされているショートカットファイルを検出し、現在のユーザーのドキュメントフォルダーの下に CSP-MCP-Assets としてアセットルートを作成します。それらの場所が異なる場合は、-ShortcutProfileFiles と -AssetsRoot を使用してください。また、リポジトリの不活性な mcp-dialog-smoke.svg フィクスチャを、そのファイル名が存在しない場合にInputルートにコピーします。既存のファイルを上書きすることはありません。

実行時、設定は次の順序で解決されます: CSP_MCP_CONFIG 内の絶対パス、次に config/config.local.json、次に追跡されたプレースホルダー config/config.json。追跡されたファイルはテンプレートであり、信頼できるマシンプロファイルではありません。

生成されたハッシュは、任意の実行可能ファイルやショートカットファイルが信頼できることの証明ではなく、すでに検査したマシンの証明として扱ってください。

2. ロックされた依存関係をインストールする

& .\scripts\install.ps1

インストーラーはリポジトリ内に .venv を作成し、requirements.lock.txt から mcp==1.29.0、pywin32==312、Pillow==12.3.0 をハッシュ強制付きでインストールします。ACL監査が信頼できない祖先を拒否した場合は、チェックアウト/アセットを信頼できるディレクトリに移動するか、管理者に祖先ACLを確認してもらってください。明示的なリスク受諾スイッチは、最初の祖先ゲートのみをスキップします。ACLを修復したり、監査されたすべてのルートとファイルツリーが保護されるという最終要件をバイパスしたりしません。

3. 登録前にテストする

$Python = Join-Path $PWD '.venv\Scripts\python.exe'

& $Python -X utf8 -m compileall -q csp_mcp server.py tests
& $Python -X utf8 -m unittest discover -s tests -p 'test_*.py' -v
& $Python -X utf8 .\tests\smoke_stdio.py

コンパイルと単体テストは、GitHub ActionsのWindows/Python 3.13で実行されます。stdioスモークテストには、さらに有効なローカル設定とサポートされているCSP環境が必要です。これは意図的にホスト型CIから除外されています。

オプションの対話型受け入れテストは、CSPを復元してフォーカスし、既知のWindowsファイルダイアログを開き、設定済みのフィクスチャパスを送信せずに検証し、その正確なダイアログをキャンセルし、スクリーンショットを比較します:

& $Python -X utf8 .\tests\acceptance_interactive.py

サポートされているCSPビルドが開いていて、ドキュメント保存プロンプトが表示されておらず、マウスやキーボードを同時に使用していない場合にのみ実行してください。手動レビューの代わりにはなりません。

4. Codexに登録する

& .\scripts\register-codex.ps1

登録後にCodexを再起動し、csp_health を呼び出してから csp_capabilities を呼び出します。登録を削除するには、次を実行します:

& .\scripts\unregister-codex.ps1

登録と登録解除は、Codexの config.toml の横にタイムスタンプ付きのロールバックバックアップを保持します。そのバックアップには、以前の完全なCodex設定が含まれており、機密性の高い環境値が含まれる場合があります。スクリプトは、その場所での再解析ポイントや安全でない書き込みACLを拒否します。ディレクトリを保護し、新しい登録が機能することを確認したら、古いバックアップを削除してください。

登録では、writes がデフォルトの承認モードとして維持されます。サーバー発行の使い捨てプリフライトトークンなしでは動作できない10個のアトミックコンシューマーのみを自動承認します: 移動、クリック、ドラッグ、スクロール、テキスト、ナビゲーションキー、登録済みコマンド、オートアクション、コマンドシーケンス、厳格なネイティブファイルダイアログ。csp_preflight 自体は承認ゲートのままです。

確認トークンフロー

通常の可視UI入力の場合:

1. csp_health、csp_capabilities、csp_get_state を呼び出します。

2. 読み取り専用の計画のために csp_capture を呼び出します。

3. 古いキャプチャIDなしで csp_preflight(operation="input", identifier="exact_tool_name", parameters_json="exact JSON parameters") を呼び出します。

4. ユーザーがプリフライトを承認した後、すぐに csp_capture を再度呼び出し、ターゲットがまだ表示されていることを確認します。

5. 新しい captureId、返された confirmToken、およびバイト単位で同等のビジネスパラメータを使用して、正確なアトミックツールを呼び出します。

6. 操作後のキャプチャを検査し、次の入力のためにプリフライトを繰り返します。

トークンは45秒後に期限切れになり、使い捨てで、完全なパラメータと正確なCSPウィンドウ/ダイアログIDにバインドされ、フォアグラウンド、ピクセル、生成、または入力時間の変更によって無効になります。パラメータの不一致はトークンを消費します。csp_cancel は狭い例外です。これはホスト承認ゲートのままであり、正確なCSPメインウィンドウまたはその一意の検証済み標準ダイアログにのみ1つの Escape を送信します。

MCPプロトコルは、人間がホストプロンプトを承認したという暗号化証明をサーバーに提供しません。したがって、信頼境界には設定済みのCodexホストが含まれます。同じユーザーとして実行される悪意のあるカスタムstdioクライアントは範囲外です。セキュリティモデルを参照してください。

ファイル操作

パスを取るツールは、ローカル設定によって作成された3つのルート内でのみ動作します。UNC/デバイスパス、代替データストリーム、ワイルドカード、予約済みデバイス名、再解析ポイント、暗黙の上書き、その他のサポートされていないケースを拒否します。既存のパスはハンドルを通じてチェックされ、既存の入力/置換ターゲットはハードリンクについてチェックされますが、これらの緩和策はすべてのチェック・ツー・ユースの競合を排除することはできません。

ファイルの保存または置換は、次の明示的なフローを使用します:

1. csp_validate_path で正確なターゲットを検証します。

2. 登録済みの document.save_as_dialog コマンドをプリフライトして実行します。

3. 正確なメイン/ダイアログHWNDを取得し、完全なパス、意図、送信フラグを使用して csp_native_file_dialog をプリフライトします。

4. 検証済みのファイルダイアログコントロールプロファイルを通じてのみ送信します。その後の上書き/フォーマットプロンプトは手動で処理する必要があります。

5. csp_wait_for_file が安定した非空のターゲットを検証し、そのSHA-256を返した後にのみ完了を受け入れます。

Ctrl+S は、CSPが公開APIを通じて現在のドキュメントパスを公開しないため、登録されていません。汎用の座標/テキストツールは、開く/保存/エクスポート、アカウント、クラウド、ストア、コミュニティ、または公開ワークフローに使用してはなりません。

csp_open_document は、参照デプロイメントでその動作が観察されたため、CLIPStudioPaint.exe <path> を引数配列としてディスパッチします。CELSYSはこれを安定したCLIコントラクトとして文書化していません。成功した応答は、ディスパッチとCSPウィンドウの証拠を証明しますが、どのドキュメントタブがパスを所有しているかは証明しません。キャプチャで結果を検証してください。

オートアクション

追跡されたオートアクションレジストリは空で始まります。CSPで各アクションを作成して手動で検証し、Ctrl+Alt+[Shift]+F1..F12 のみをバインドしてから、オートアクション設定の説明に従ってローカルに登録します。

• オートアクションはCSP PRO/EXで利用可能であり、DEBUTでは利用できません。

• すべてのアクションにはプリフライトと正確な登録IDが必要です。

• プロダクション設定は effect: "filesystem" を拒否します。

• 各エントリは attested_no_file_io: true を証明する必要があります。

• サーバーは独自の .laf ファイルを解析できないため、その証明は技術的な証明ではなく管理者の約束です。

開く/保存/エクスポートには、専用の検証済みファイルワークフローを使用してください。

プロジェクトレイアウト

.
├─ csp_mcp\                 MCP application, policy, controller, Win32 backend
├─ config\                  tracked examples and registries
├─ docs\                    tools, security, research, Auto Actions
├─ scripts\                 configure, install, register, unregister, ACL audit
├─ tests\                   unit, stdio smoke, opt-in interactive acceptance
├─ server.py                stdio entry point
├─ pyproject.toml
├─ requirements.txt
└─ requirements.lock.txt

ドキュメントとソース

• ツールカタログ

• セキュリティモデル

• オートアクション設定

• GitHubプロジェクト比較

• OpenAI Codex MCPドキュメント

• CELSYSオートアクションマニュアル

• CELSYS公開SDKページ

• CELSYSサポート対象の開く/インポート形式

開発とリリース境界

Pull requestsは、フェイルクローズドなバージョン/署名/プロファイルチェックを維持し、動作変更に対するテストを追加する必要があります。ホスト型CIはコンパイルと単体テストのみを実行します。CSP依存のスモークテストと対話的検証には、明示的に準備されたWindowsワークステーションが必要です。CONTRIBUTING.mdとセキュリティポリシーを参照してください。

同梱のプロファイルは、上記の正確なターゲットに対してのみ検証されます。CSPの更新、言語の変更、DPIの変更、ショートカットの編集、またはライセンスエディションの変更には、新しいプロファイルを公開する前に、新しい署名/ハッシュチェック、スクリーンショットのキャリブレーション、ショートカットの検証、および非破壊的な受け入れテストが必要です。

ライセンスと商標

このプロジェクトはMITライセンスの下で利用可能です。サードパーティの依存関係に関する通知は、THIRD_PARTY_NOTICES.mdに記録されています。

CLIP STUDIO PAINTおよびCELSYSは、それぞれの所有者の商標です。このリポジトリは、CELSYSのソフトウェア、SDKソース、プライベートプロトコル、またはリバースエンジニアリングされた.clip形式のコードを配布しません。