Impactor

Impactor MCP サーバー

Impactor のサイドローダーと同じ操作を、任意のAIエージェントまたはMCPクライアント（Claude、Cursor、VS Code Copilot、Windsurfなど）で実行できる MCP サーバーです。Apple IDでのサインイン（2FAを含む）、開発者ポータルの証明書／デバイス／アプリIDの管理、調整やカスタマイズを加えた .ipa ファイルへの署名とインストール、ペアリングファイルのインストール、有効期限が切れる前のアプリの更新に対応しています。

これは単体のアドオンです。公式のImpactorリリース（Cargoで取得する v2.7.0）をベースにビルドし、Impactorのデータディレクトリを共有するため、標準のImpactorアプリと並行して動作します。アプリを改変したビルドにする必要はありません。アプリでログインしたアカウントはここにも表示され、その逆も同様です。

Claudeが作成しました。 このMCPサーバー、インストーラー、READMEは、AnthropicのAIモデルであるClaudeがClaude Codeを使って作成しました。これは非公式の関連プロジェクトであり、Impactorの作者とは提携しておらず、承認も受けていません。

機能

エージェントからの1回のリクエストで、Impactorアプリをクリックして進めるのと同じ手順を実行できます。

インストール

1行のコマンドで実行できます。手動でクローンやダウンロードをする必要はありません。

Windows（PowerShell）：

irm https://raw.githubusercontent.com/YeetDisDude/impactor-mcp/main/install.ps1 | iex

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/YeetDisDude/impactor-mcp/main/install.sh | sh

インストーラーは、プラットフォーム用のビルド済みバイナリを最新のリリースからダウンロードします（Rustは不要です）。お使いのプラットフォーム用のバイナリがない場合は、必要に応じてRustを先にインストールしたうえで、cargoを使ってソースからビルドします。その後、バイナリをWindowsでは %LOCALAPPDATA%\impactor-mcp\impactor-mcp.exe、それ以外では ~/.local/bin/impactor-mcp にインストールし、Claude Code（claude mcp add、ユーザースコープ）とClaude Desktop（claude_desktop_config.json。.bakのコピーを保持）に登録します。その後、Claude Desktopを再起動してください。ローカルクローンからinstall.ps1／install.shを実行した場合もビルド済みバイナリをダウンロードします。ソースからビルドするのは、-FromSource／--from-sourceを指定した場合、またはお使いのプラットフォーム用のビルド済みバイナリがない場合のみです。

Claude Desktop（ワンクリック）： 最新のリリースからimpactor-mcp.mcpbをダウンロードして開いてください。Claude Desktopが拡張機能としてインストールします。このサーバーはMCP Registryにもio.github.YeetDisDude/impactor-mcpとして登録されています。

オプションを指定する場合：

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/YeetDisDude/impactor-mcp/main/install.ps1))) -AutoRefresh

curl -fsSL https://raw.githubusercontent.com/YeetDisDude/impactor-mcp/main/install.sh | sh -s -- --auto-refresh

オプション（ps1 / sh）	効果
-NoClaudeCode / --no-claude-code	Claude Codeに登録しません
-NoDesktop / --no-desktop	Claude Desktopの設定を変更しません
-AutoRefresh / --auto-refresh	保存済みアプリをバックグラウンドで更新します（下記参照）
-FromSource / --from-source	ビルド済みバイナリをダウンロードせず、cargoでビルドします
-NoAutoRefresh / --no-auto-refresh	更新時に自動更新を無効にします
-Uninstall / --uninstall	バイナリと両方の登録を削除します

更新

同じインストールコマンドをもう一度実行してください。Claudeが使用中でも、バイナリが最新リリースに置き換わり、自動更新の設定は保持されます。その後、Claude Desktopと、実行中のClaude Codeセッションを再起動して新しいバージョンを読み込んでください。.mcpb拡張機能をインストールした場合は、新しいimpactor-mcp.mcpbをダウンロードして開いてください。cargo installを使った場合は、--forceを付けて再実行してください。

要件

• Windows： デバイスにアクセスするには、iTunes または Apple Devices（Microsoft Store）が必要です。
• Linux： usbmuxd が必要です。
• ソースからビルドする場合のみ：Windows では MSVC C++ ビルドツール （winget install Microsoft.VisualStudio.2022.BuildTools）、macOS では Xcode コマンドラインツールが必要です。

手動セットアップ

cargo install --locked --git https://github.com/YeetDisDude/impactor-mcp impactor-mcp
claude mcp add --scope user impactor -- ~/.cargo/bin/impactor-mcp

その他の MCP クライアント（Cursor、VS Code、Windsurf、Cline など）でも、MCP 設定内で同じ stdio エントリを使用します。

{ "mcpServers": { "impactor": { "command": "/absolute/path/to/impactor-mcp", "args": [] } } }

ツール

領域	ツール
アカウント	account_list、account_login、account_submit_2fa、account_cancel_login、account_switch、account_remove、account_teams、account_set_team、settings_set_locale
デベロッパーポータル	portal_account_info、portal_list_certificates、portal_revoke_certificate、portal_list_devices、portal_register_device、portal_list_app_ids、portal_delete_app_id、portal_list_app_groups、portal_download_profile、portal_export_certificate
デバイス	device_list、device_info、device_pair、device_list_apps、device_install_app、device_install_pairing_file、device_install_profile、device_is_app_installed
署名	package_inspect、sign_and_install、sign_list_app_types
Mach-O	macho_info、macho_edit
自動更新	refresh_list、refresh_app_now、refresh_run_due、refresh_forget_app

sign_and_install は、アプリのインストール画面全体の機能をカバーします。Apple ID／アドホック／PEM／変更なしの署名、インストールおよび／またはエクスポート、カスタム名／バンドル ID／バージョン／アイコン／エンタイトルメント、単一プロファイル、tweak（.deb、.dylib、.framework、.bundle、.appex）、機能切り替え項目（最小 OS、ファイル共有、iPad のフルスクリーン、ゲームモード、ProMotion、Liquid Glass、ElleKit）、ペアリングファイルのインストール、自動更新用の保存に対応しています。時間のかかる操作では、MCP の進捗通知が送信されます。

プロンプトの例：

• 「Apple ID で Impactor にログインして」（ブラウザーでサインインページが開きます）
• 「~/Downloads/SideStore.ipa に署名して iPhone にインストールし、更新も続けて」
• 「この tweak をアプリに挿入して、署名済み ipa をデスクトップにエクスポートして」

注意事項

• サインインについて。 account_login は、ブラウザーで 127.0.0.1 のサインインページを開きます。そこで Apple ID、パスワード、2FA コードを入力するため、パスワードがエージェントや会話を経由することはありません。エージェントは結果を待ちます。対応しているクライアントでは、引き続き email と password を直接渡すこともできます。
• Apple による -80045 ブロック（2026 年 10 月）。 Apple が anisette サーバーから報告されるクライアント情報を拒否し始めたため、Impactor へのログインはすべて -80045 で失敗していました。この問題は、このサーバーが依存する Impactor v2.7.0 で上流修正済みです。ローカルでの回避策は不要です。
• 証明書のリセット。 無料アカウントで保持できる開発用証明書は数枚のみです。新しい証明書が必要になった際に上限に達している場合、ツールは何も失効させず、ヒントを返して失敗します。既存の SideStore／AltStore のインストールが動作しなくなることを承知している場合に限り、allow_certificate_reset: true を渡してください。
• 自動更新。 refresh: true を指定してインストールしたアプリは、refresh_run_due を呼び出すと7日間のプロファイルの有効期限が切れる前に再署名されます。または、サーバーを IMPACTOR_MCP_AUTO_REFRESH=1 で実行すると、3分ごとに自動で更新されます。Impactor アプリには独自の更新デーモンがあります。自動更新はどちらか一方だけで有効にしてください。
• 共有データ。 どちらも、Windows では %APPDATA%\PlumeImpactor、それ以外では ~/.config/PlumeImpactor にある accounts.json を使用します。アプリはデータのコピーをメモリに保持するため、ここで行った変更（新しいログインなど）をアプリに反映するには、アプリの再起動が必要な場合があります。
• ログは stderr に出力されます（stdout はプロトコル用のチャネルです）。詳細を表示するには RUST_LOG=debug を設定してください。
• 新しい Impactor リリースへの追従： Cargo.toml の tag の値を更新して、cargo update を実行してください。

リリース

v2.7.0 のようなタグをプッシュすると、.github/workflows/release.yml が実行されます。Windows、macOS、Linux 向けのバイナリ（x86_64 と arm64）をビルドし、インストーラーがダウンロードする GitHub リリースに添付します。

クレジット

claration による Impactor（MIT）と idevice を基に構築されています。MCP サーバー自体は Claude が作成しました。