Impactor

Impactor MCP 服务

一个 MCP 服务，可让任何 AI Agent 或 MCP 客户端（Claude、Cursor、VS Code Copilot、Windsurf 等）完成 Impactor 侧载工具所能完成的所有操作：使用 Apple ID 登录（包括 双重验证），管理开发者门户中的证书、设备和应用 ID，为 .ipa 文件签名并安装（支持调整和自定义），安装配对文件，并在应用过期前保持其更新。

它是一个独立附加组件。它基于官方 Impactor 版本（v2.7.0，由 Cargo 获取）构建，并共用 Impactor 的数据目录，因此可与原版 Impactor 应用一起使用——你无需使用经过修改的应用构建版本。在应用中登录的帐户也会显示在这里，反之亦然。

由 Claude 制作。 此 MCP 服务、安装程序和本 README 均由 Claude（Anthropic 的 AI 模型）通过 Claude Code 编写。这是一个非官方的 配套项目，与 Impactor 作者无关，也未获得其认可。

功能

Agent 发出一个请求，就会执行你在 Impactor 应用中手动点击完成的相同步骤：

安装

只需一行命令，无需手动克隆或下载：

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）。如果你的平台没有对应版本，则会使用 cargo 从源代码构建；必要时会先安装 Rust。随后，安装程序会将二进制文件安装到 %LOCALAPPDATA%\impactor-mcp\impactor-mcp.exe（Windows）或 ~/.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／ad-hoc／PEM／不修改签名、安装和／或导出、自定义名称／bundle id／版本／图标／entitlements、单个描述文件、插件（.deb、.dylib、.framework、.bundle、.appex）、功能开关（最低 OS 版本、文件共享、iPad 全屏、游戏模式、ProMotion、Liquid Glass、ElleKit）、配对文件安装，以及保存以供自动刷新。长时间运行的操作会报告 MCP 进度通知。

提示词示例：

• “用我的 Apple ID 登录 Impactor”（浏览器中会打开登录页面）
• “对 ~/Downloads/SideStore.ipa 签名并安装到我的 iPhone 上，同时保持刷新”
• “将这个插件注入应用，并把签名后的 ipa 导出到我的桌面”

说明

• 登录。 account_login 会在浏览器中打开 127.0.0.1 上的登录页面。你在此输入 Apple ID、密码和 2FA 验证码，因此密码不会经过 Agent 或其对话。Agent 会等待结果。支持此功能的客户端仍可直接传入 email 和 password。
• Apple 的 -80045 封锁（2026 年 10 月）。 Apple 开始拒绝 anisette 服务报告的客户端信息，导致所有 Impactor 登录都失败并返回 -80045。上游已在 Impactor v2.7.0 中修复此问题，本服务基于该版本构建；无需本地变通处理。
• 证书重置。 免费账户只能持有少量开发证书。需要新证书但已达到上限时，工具会提供提示并失败，而不会撤销任何证书。只有在接受现有 SideStore／AltStore 安装失效的情况下，才传入 allow_certificate_reset: true。
• 自动刷新。 使用 refresh: true 安装的应用会在其 7 天描述文件过期前重新签名：调用 refresh_run_due 时会执行，或者在服务以 IMPACTOR_MCP_AUTO_REFRESH=1 运行时每 3 分钟自动执行一次。Impactor 应用有自己的刷新守护进程；只在其中一处启用自动刷新。
• 共享数据。 两者都会使用 %APPDATA%\PlumeImpactor（Windows）或 ~/.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 开发。