Logic Pro MCP Server 面向 Claude、Cursor 和 AI 代理

一个本地 Model Context Protocol (MCP) 服务器，让 Claude Code、Claude Desktop、Cursor、VS Code 和自定义 AI 代理能够控制 Logic Pro 进行 AI 音乐制作：创建音轨、编写 MIDI、操作走带和混音器状态、检查实时项目数据并验证结果。

安装 · 观看演示 · 它控制什么

🏆 入选 Anthropic 的 Claude for Open Source 计划

Logic Pro MCP 已正式入选 Anthropic 的 Claude for Open Source 计划——这是来自 Claude 开发者的认可，表明该项目是值得支持的开源工作。该服务器由 Claude 构建，为 Claude 驱动的代理而生——并且现已获得该计划的官方支持。

Logic Pro MCP Server 为 Claude、Cursor 和自定义 AI 代理提供了一种结构化的方式来控制 Logic Pro，而不依赖脆弱的键盘宏。Logic Pro 并未提供用于代理式作曲、会话设置、混音器操作或实时项目回读的第一方 API，因此 Logic Pro MCP 通过在单个 MCP 接口背后整合 7 个原生 macOS 控制通道 来填补这一空白，并为每个高风险操作设定明确的状态、确认和验证契约。

结果并不是“带提示词的屏幕自动化”。它是一个面向 DAW 代理的结构化服务器：工具负责变更，资源负责读取，证据有明确标注，不确定的结果保持不确定，而不是被报告为成功。

You: "Make a 4-bar techno loop in A minor at 140 BPM"

MCP client → logic_tracks.record_sequence {
  bar: 1, tempo: 140,
  notes: "45,0,95;57,107,95;45,214,95;..."
}
MCP client → logic_tracks.set_instrument {
  index: 0, path: "Electronic Drums/Roland TR-909"
}

Logic Pro MCP: region imported, instrument routed, readback exposed through resources.

概览

如果这个项目帮助你使用 Claude、Cursor 或任何 MCP 客户端创作音乐，请为仓库点星。这有助于项目触达更多 Logic Pro 用户和维护者。

想贡献代码？请从贡献指南和开放问题开始。许多文档、示例、验证测试和 CLI 消息改进都不需要 Logic Pro。

Related MCP server: Logic Pro MCP Server

为什么存在

大多数 Logic Pro 自动化尝试都会落入以下三个陷阱之一：

1. 仅提示词的方案：偏离真实工具表面。

2. 键盘宏自动化：可能点错目标却仍然看似成功。

3. 单通道控制：可以写入 Logic，但无法可靠地读取 Logic 实际做了什么。

Logic Pro MCP 采用不同的模型。它将每个操作路由到可用的最强通道，通过 MCP 资源暴露实时状态，并强制调用方处理三种结果：已确认、不确定或失败。

它控制什么

智能体级界面

工具用于执行操作和本地产物检查。 公开的写入面刻意很小：logic_transport、logic_tracks、logic_mixer、logic_plugins、logic_midi、logic_edit、logic_navigate、logic_project 和 logic_system。logic_audio 是只读的，会在 Logic 写入后验证导出的文件。

资源用于状态。 客户端应读取 logic://transport/state、logic://tracks、logic://mixer、logic://project/info、logic://project/audit、logic://project/cleanup-plan、logic://midi/ports 及相关资源，而不是把工具调用浪费在轮询上。

证据与声明分离。 README 指向发布证据、当前主分支验证和实时媒体产物，而不是暗示命令成功就等于 Logic 状态已验证。

信任模型

• 诚实契约信封（Honest Contract envelopes）：变更操作返回状态 A（已确认）、状态 B（不确定，附原因）或状态 C（失败，附错误）。

• 已验证的插件回写（Verified plugin apply-back）：logic_plugins.* 使用 HC v2（hc_schema: 2），仅在项目身份、目标轨道、物理插入槽、插件身份和回读全部一致后才返回状态 A。

• 故障安全关闭的目标（Fail-closed targets）：危险的混音器、标记、轨道、MIDI 导入和插件操作需要明确的目标和验证。

• 确认级别（Confirmation levels）：破坏性/项目和插件插入流程在执行前需要明确的确认元数据。

• 来源标签（Provenance labels）：读取界面暴露来源、新鲜度和证据标签，而不是让客户端去猜测。

• 安装器加固（Installer hardening）：Homebrew 固定 SHA256；shell 安装器在没有明确的哈希/团队固定时拒绝运行，除非显式允许同源来源。

• 发布诚实（Release honesty）：已发布的 v3.13.0 是当前稳定安装线，README 中的声明始终与已发布的产物、发布树测试或明确链接的实时证据挂钩。

快速开始

先决条件：MCP 服务器需要 macOS 14+；Logic Pro（优先支持最新版本——目前为 12.3，Apple 将其列为需要 macOS 15.6+；低至 12.0.1 下限的旧版本为尽力支持）；以及一个能够启动 stdio 服务器的 MCP 客户端。已发布的 GitHub Actions/Homebrew 产物是通用二进制（arm64 + x86_64），不需要 Xcode。Bounce/导出使用随附的原生 CGEvent 辅助程序，没有第三方点击二进制。

Logic Pro 版本策略。 Logic Pro MCP 将最新 Logic Pro 版本作为一级目标，并针对它进行验证（严格的实时 E2E 在 Logic Pro 12.3 上运行）。当 Apple 发布新版 Logic Pro 时，支持它是最高优先级——辅助功能/UI 树会随版本变化，因此新版本是修复最先落地的地方。高于 12.0.1 下限的旧版本仍为尽力支持，并可能随着这些 UI 表面的变化而失去对等性。

包清单使用 Swift tools 6.0 以保证兼容性。当前源码验证在 CI 中使用 Xcode 16.4 / Swift 6.2。

当前发布的稳定版本是 v3.13.0（2026-07-22 UTC）。当缺少 Apple Developer ID 凭证时，它会提供 ADHOC 签名的通用产物，此外还有 SHA256SUMS.txt 和 RELEASE-METADATA.json，用于固定安装。运行时表面变为 10 个工具 / 18 个资源 / 12 个资源模板——生成的只读操作目录 logic://system/operations 作为第 12 个模板发布。要点：无坐标驱动计划（静音/独奏/预备、应用菜单项、区域选择使用 AX 操作和键盘命令，并带有观察效果验证；外部点击工具回退已退役）、需同意才能启用的录音预备键盘命令自动设置（system.setup_arm_key）、语言环境无关的模态窗口分类器（本地化的插件编辑器和 Drummer Smart Controls 面板不再阻塞无关操作，而真正的模态窗口仍会保持阻塞）、ADR 内核行为默认开启（会话稳定的 target_ref、带严格参数的操作契约注册表、已验证变更的 saga 预检、操作跟踪）、经过 SecureFD 加固的 trace-clear/support-bundle 路径并带有有界的 saga 生命周期截止时间，以及恢复 bounce/导出功能的 Homebrew 打包修复（logic_variants.py 现已包含——#427）。它保留了 v3.9.0 的 MCP 能力新增（transport.toggle_autopunch、资源订阅、工作流提示、每个工具的 outputSchema / structuredContent）、v3.9.2 的已验证插件关闭窗口修复，以及 v3.10.0 的桌面/Creator Studio 定位。两个 v3.9.0 仅实时界面（MIDI 导出回读、Channel EQ 已验证参数）仍然被诚实地推迟，并附有 spike 证据。

1. 安装

brew tap MongLong0214/logic-pro-mcp https://github.com/MongLong0214/logic-pro-mcp
brew trust monglong0214/logic-pro-mcp   # Homebrew 6.0+ requires trusting third-party taps
brew install logic-pro-mcp

Homebrew 公式固定了发布 tarball 的 URL 及其 SHA256；Homebrew 本身就是一个带有自己的签名链的可信交付渠道。这是生产安装的加固路径。（在低于 6.0 的 Homebrew 上，brew trust 步骤不存在——跳过它。）

对于源码树开发，请在本地构建：

git clone https://github.com/MongLong0214/logic-pro-mcp.git
cd logic-pro-mcp
swift build -c release

2. 注册到 MCP 客户端

Claude Code：

claude mcp add --scope user logic-pro -- LogicProMCP

通用 MCP 客户端配置：

{
  "mcpServers": {
    "logic-pro": {
      "command": "LogicProMCP"
    }
  }
}

如果你从源码构建，请将命令指向 .build/release/LogicProMCP。

3. 完成 Logic Pro 设置

运行本地检查：

LogicProMCP --check-permissions

然后完成 docs/SETUP.md 中的两个 Logic 端设置步骤：

• 注册 LogicProMCP-MCU-Internal MCU 控制表面。

• 如果你需要插件参数写入，请添加随附的 Scripter 插件插入。

Logic 12.2+ 不会自动导入旧版 Key Commands plist；随附的预设会作为 Manual MIDI Learn 参考暂存。

4. 从你的智能体进行测试

向客户端提问：

检查 Logic Pro MCP 健康状态，并显示所有就绪通道。

预期：完整设置后所有 7 个通道均为 ready；如果你有意跳过 Key Commands 和 Scripter，则为 5 个。

固定的 shell 安装器

该安装器是**故障安全关闭（fail-closed）**的：如果没有显式的 LOGIC_PRO_MCP_SHA256 + LOGIC_PRO_MCP_TEAM_ID 环境变量固定，它会拒绝运行。它会验证下载的 LogicProMCP-macOS-universal.tar.gz 归档文件，因此请从发布版的 SHA256SUMS.txt 中复制该归档条目的 SHA：

curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.13.0/Scripts/install.sh -o install.sh
# inspect install.sh, then:
LOGIC_PRO_MCP_SHA256=<paste LogicProMCP-macOS-universal.tar.gz SHA256SUMS entry> \
LOGIC_PRO_MCP_TEAM_ID=<paste team_id from RELEASE-METADATA.json> \
bash install.sh

如果你有意接受同源来源（哈希和 Team ID 与二进制文件从同一发布版本获取），请显式选择启用：

LOGIC_PRO_MCP_ALLOW_SAME_ORIGIN=1 \
bash <(curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.13.0/Scripts/install.sh)

信任层级和威胁模型见 SECURITY.md §安装器信任模型。

设置诊断

要让智能体可靠地驱动 Logic Pro，这主要是一个权限和环境问题：TCC 授权、正确的 Logic 版本、打开的文档、已注册的控制表面、没有阻塞的模态窗口。LogicProMCP doctor 是一个一流的、意图感知的就绪平台，正是为此而构建——它不是布尔式的“是否已安装”检查，而是一个诊断工具，告诉你哪些能力已就绪、哪些被阻塞、为什么，以及下一步该怎么做——并且永远不会对实际未能验证的内容报告为绿色。

LogicProMCP doctor                 # human-readable report, color when a TTY
LogicProMCP doctor --json          # stable machine contract (schema logic_pro_mcp_doctor.v4)
LogicProMCP doctor --strict        # exit code encodes overall status (CI gate)
LogicProMCP doctor --profile core --client claude-desktop
LogicProMCP doctor --check-updates # opt-in: also checks for a newer release

意图感知的配置档（Intent-aware profiles）。 你不会被迫穿过永远不会用到的检查。--profile 将必需集合限定为你实际驱动 Logic 的方式——core（transport/tracks/AX）、mixer、keycmd、legacy-scripter 或 full。--client（claude-code、claude-desktop、cursor、vscode、terminal、custom）会添加与该主机相关的注册检查。聚合状态限定于所选配置档的必需检查，因此仅使用 MCU 的工作流不会因为永远不会遇到的 Scripter 缺口而被标记为不健康。

能力就绪，而不仅仅是检查通过/失败。 每个检查都会映射到它所门控的能力（track_management、midi_import、mixer_ax、mixer_mcu、keycmd_only_ops、verified_plugin_applyback、project_lifecycle，……）。报告会告诉你*“MIDI 导入已就绪；已验证插件回写被 PostEvent 阻塞”*——这是一种智能体（或操作员）可以直接行动的语言。

因果链——fix_plan 和 blocked_by。 失败会被排列进一个 fix_plan（下一步操作，最能解除阻塞的优先），每个下游检查都会指出它 blocked_by 哪个上游检查——这样你修复的是根源，而不是症状。headline 会重述唯一的下一个操作。

诚实是核心要点。 无法运行的检查（能力缺失、TCC 数据库不可读）会明确报告为 skipped 并附上原因——绝不会被静默归入通过。有意跳过的检查（--skip-channel <MIDIKeyCommands|Scripter>，以及可选的 --skip-note，例如你故意未注册 Scripter）会被记录并从就绪状态评估中排除，而不会伪造通过结果。TCC 发现项会脱敏为服务/主体/状态摘要——报告中不会出现原始本地路径。

它验证的权限面。 --check-permissions 会汇总真实代理所需的四项 TCC 授权，并在任一缺失时以非零状态退出：辅助功能、自动化 → Logic Pro、自动化 → 系统事件（这是一个独立目标——Logic 被授权并不意味着系统事件也被授权），以及 PostEvent（输入监控，CGEvent 弹跳/点击回退方案所需）。诊断工具将这些能力视为独立项，因为它们会分别失败：例如，来自系统事件的 -1743 / errAEEventNotPermitted 是启动器权限缺口（负责启动服务器的进程未被授予自动化 → 系统事件权限），会如实报告并附上精确的修复方法——而不会错误归因于 Logic。

严格退出码（--strict，用于 CI/代理门禁）：0 正常 · 1 失败 · 2 需要手动操作 · 3 降级。2 和 3 是状态码，而非用法错误，位于 sysexits.h 范围之下。

一次真实的（已脱敏的）在配置中途机器上的运行：

{
  "schema": "logic_pro_mcp_doctor.v4",
  "doctor_profile": "core",
  "status": "failed",
  "headline": "Next action [permissions.accessibility]: Accessibility permission is not granted",
  "fix_plan": ["permissions.accessibility", "permissions.post_event_access", "install.binary_inventory"],
  "summary": { "total": 26, "passed": 15, "warnings": 1, "failed": 2, "skipped": 8, "manual": 0, "duration_ms": 333 },
  "checks": [ { "id": "binary.path", "status": "pass", "category": "installation", "severity": "info" } /* … */ ]
}

同一运行在终端中会输出分组、彩色编码的报告，并为每项检查提供指向 docs/SETUP.md 的修复指引锚点。完整的标志参考和每项检查的修复方法都位于 docs/SETUP.md 中；--json 输出字节是稳定的契约，你可以在自己的自动化 onboarding 流程中对其断言。

架构概览

MCP 客户端启动 Swift stdio 服务器。调度器验证工具参数，ChannelRouter 选择当前可用的最强 macOS 通道，资源暴露缓存/实时状态，高风险写入返回明确的 已确认/不确定/失败 信封。核心通道包括 MCU、辅助功能、AppleScript、CoreMIDI、CGEvent、Scripter 和 MIDI 键盘命令。

文档

公共文档树的范围是刻意限定的：设置、API、故障排查、README 媒体文件，以及解释已上线或已修复的用户可见问题的公共 issue/工单。历史发布说明、内部工单、私有问题看板、临时笔记和本地工作证据文件都不放在 docs/ 中；公共发布历史归属于 CHANGELOG.md、GitHub Releases、已合并的 PR 和 issue 历史。

状态

已发布稳定版：v3.13.0 已通过 GitHub Release 和 Homebrew 安装提供。它汇集了 v3.6.0 → v3.11.0 的累积修复，恢复了 Homebrew 的 bounce/export 功能（通过将 logic_variants.py 打包并加入导入闭包检查，issue #427），实现了 coordinate-free 的 actuation campaign 和 consent-gated 的 arm 自动设置（issue #413），修复了 localized-editor/Smart Controls 模态框误判问题（issues #381、#405），并默认启用了 ADR-002/003/004/005 的内核行为，配合 SecureFD/saga 加固（issues #417、#412）。当缺少开发者 ID 证书时，发布的元数据仍保持 team_id:"ADHOC" / signing:"adhoc"，产物为通过 GitHub Actions 构建的通用二进制（x86_64 + arm64）。

上一稳定版：v3.10.0 仍可作为 Creator Studio 支持版本使用；v3.9.2 仍可作为已验证的插件参数写入修复版本使用；v3.9.1 及更早版本仍可用于固定版本安装。

验证

真实 E2E 默认使用发布二进制。协议/安全断言可在任何主机上运行；Logic/CoreMIDI 相关检查在未检测到真实 Logic Pro 会话时会跳过。严格模式会将真实环境门控的跳过项转换为失败，将缺失的工程状态视为 cycle 往返前置条件失败，并以受信任的 shell/tmux 父进程启动 MCP 服务器，以便 macOS TCC 评估与真实客户端流程所使用的相同父上下文。

重要的 API 契约

• 诚实合约信封 — 每个变更操作返回状态 A（已确认）、状态 B（不确定，附 reason）或状态 C（硬失败，附 error）。参见 docs/API.md。

• HC v2 插件应用回读 — logic_plugins.get_inventory、set_param_verified 和 insert_verified 添加 state + hc_schema: 2；状态 C 始终携带 verified:false、write_attempted、重试安全性和相关目标身份。

• 故障关闭的变更目标 — 混音器推子、插件参数、标记删除/重命名、轨道删除/复制以及 MIDI 导入需要显式目标参数。

• 精确槽位插件插入 — logic_plugins.insert_verified 以 get_inventory 返回的物理插入索引为目标，验证弹出窗口锚定到该槽位，并且仅通过写入后库存差异确认成功。

• 忠实于目标的导航 — goto_marker 在冷缓存时返回 element_not_found，而不是前进到下一个标记。

• 1 基 MIDI 通道 — send_note、send_cc 和 record_sequence 的 ch 值接受 1..16 以匹配 Logic 的界面。

• 有界原始 SysEx — send_sysex 在 CoreMIDI 路由之前拒绝超过 1024 字节的负载。

• 可听弹跳护栏 — record_sequence 拒绝未经验证的 GM Device / External MIDI 导入，logic://project/audit 将带有 MIDI 区域的 External MIDI 轨道标记为导出阻塞项，logic_project.bounce 在打开 Bounce 对话框之前拒绝这些阻塞项。

• 审计阶段拆分 — 审计日志区分被拒绝的调用、确认提示和已执行的路由调用。

• 已验证的项目保存 — project.save_as 验证目标 .logicx 包存在，并且现有包的修改时间已推进。

• 实时项目元数据 — logic://project/info 在可用时提升实时传输速度/采样率，并逐字段回退到已保存的项目元数据。

• 无副作用读取 — 资源暴露状态、元数据和缓存库存，而不变更 Logic。

发布与分发

稳定的生产标签使用 GitHub Actions 发布工作流。RELEASE-METADATA.json 记录每个工件的确切签名模式、Team ID 和架构。当缺少 Developer ID 凭据时，发布会发布带有 SHA256 元数据和安装验证的 ADHOC 工件，而不是假装已公证。

每个版本的详细信息见 CHANGELOG.md。安全性和安装程序信任层级记录在 SECURITY.md 中。

注册表元数据

仓库为官方 MCP Registry 元数据路径提供 server.json。它固定到当前稳定版本（v3.13.0），并携带 Logic Pro、DAW 自动化、MIDI、Claude/Cursor MCP 客户端和音乐制作代理的发现标签。该记录仅为元数据，因为注册表包模式尚未将 Homebrew 公式或 GitHub 发布压缩包建模为一等包类型。安装权威仍然是上面固定的 GitHub Release/Homebrew 路径。

已知限制

• 速度输入：当 Logic 的内联速度输入未提交时，transport.set_tempo 使用有界粗调和精确 AX 滑块回退，如果精确回读仍无法验证，则故障关闭。

• MIDI 区域填充：record_sequence 区域从第 1 小节开始，使用不可听填充扩展到目标小节；区域内的音符时序是精确的，但区域可能看起来比乐句更长。

• 外部 MIDI 弹跳就绪：GM Device / External MIDI 轨道上的 MIDI 区域不被项目审计或 logic_project.bounce 接受为可听弹跳证据。在声称已验证的 Logic Bounce 之前，请将素材移动或重新创建到 Software Instrument 轨道上。

• MIDI 键盘命令：Logic 12.2 不接受旧的 .plist 键盘命令导入；仅键盘命令操作仍需要手动 MIDI Learn。

• 标记：标记创建使用 Logic 的原生 Navigate 菜单，并在 Marker List 可读时验证它。关闭/不可读的 Marker List 被报告为不可读或从最后一个可读缓存提供，而不是提升为已验证的空列表。rename_marker 仍为 not_implemented。

• 插件参数回读：logic_plugins.set_param_verified 在需要时打开目标插入的插件窗口，并通过该窗口实时验证 Compressor threshold；任意插件参数仍是未来工作，并以 unsupported_param_readback 故障关闭。

开发

源码构建需要 Xcode 16.4+ / Swift 6.2 作为当前已验证的工具链。

swift test --no-parallel
swift build -c release
python3 -m py_compile Scripts/live-e2e-test.py

对于已配置的 Logic Pro 主机上的实时证明：

LOGIC_PRO_MCP_STRICT_LIVE=1 Scripts/live-e2e-test.sh

许可证

MIT。参见 LICENSE。

贡献

欢迎提交错误报告、PR 和功能讨论。开发工作流参见 CONTRIBUTING.md 和开放问题。

安全漏洞：请不要公开发布问题。私有披露流程参见 SECURITY.md。