convez.ai
MCP ServerAutomaçãoAvançado
MongLong0214

Logic Pro MCP Server

MongLong0214/logic-pro-mcp

API natural para Logic Pro via Claude — mixer, MIDI, transporte e plugins

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que oferece controle natural em linguagem de Logic Pro via Claude e outros clientes MCP. Combina 7 canais nativos de controle do macOS (mixer, transporte, composição MIDI, biblioteca, plugins) em uma interface unificada e bidirecional, permitindo que assistentes de IA controlem determinsticamente mixagem, automação e composição.

Instalação

$npx convez-ai MongLong0214/logic-pro-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
213
Forks
48
Acompanhando
3
Saúde
71%
Último commit
há 1 dia
Versão
v3.19.0
Issues abertas
34
Contribuidores
3

Casos de uso

  • Composição automática de loops e sequências MIDI com instruções em linguagem natural
  • Controle remoto de mixer, faders e efeitos via Claude durante sessões de produção
  • Automação de workflows repetitivos em projetos de música (transporte, seleção de instrumentos, parâmetros)

Veredito

Projeto sólido e específico que preenche uma lacuna real: Logic Pro carece de API pública robusta. A abordagem de combinar 7 canais de controle é engenhosa e os 1208 testes passando indicam confiabilidade. Voltado para produtores musicais avançados que querem integrar IA em workflows profissionais.

README

A tradução para o português deste README ainda está na fila.


If this project helps you make music with Claude, Cursor, or any MCP client, give it a star. It helps this repo reach more Logic Pro users.

Logic Pro has no public API. This server bridges that gap by combining 7 native macOS control channels into a single MCP interface — giving AI assistants bidirectional, deterministic control over transport, mixing, MIDI composition, plugins, automation, and project lifecycle.

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

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

Logic Pro: region imported, TR-909 loaded, ready to play.

Why this exists

Logic Pro ships without an AppleScript dictionary rich enough for composition workflows, without OSC, and without a first-party MCP server. Every existing "Logic automation" tool either:

  1. Relies on screen-scraping via vanilla AppleScript (slow, fragile, breaks every Logic update)
  2. Simulates keyboard shortcuts (no state awareness, no feedback)
  3. Uses a single protocol like MCU alone (misses 80% of Logic's surface)

This server takes a different approach: combine seven complementary channels, route each operation to the channel best suited for it, and expose a clean MCP tool surface on top.

What it does

Mixer — Control faders, pan, sends, plugin parameters with 14-bit MCU resolution. Bidirectional: state cache reflects what Logic actually did, not what you requested.

Transport — Play, stop, record, locate, cycle, tempo, metronome. Sub-millisecond CoreMIDI MMC path; AX dialog fallback for precise bar positioning that auto-extends the project length.

MIDI composition — record_sequence generates a Standard MIDI File server-side and imports it into a new track. Zero timing drift regardless of system load; notes land at the exact requested bar.

Library & instruments — Enumerate Logic's full instrument library (Electronic Drums, Synthesizer, Bass, etc.) and load presets by path. Tree-scan caches to disk for instant subsequent lookups.

Plugins — Deterministic plugin parameter control via a Scripter JS insert on the selected track.

Navigation — Goto bar, markers by name, zoom, view toggles.

Project lifecycle — New, open, save, save-as, close, bounce, quit — all with explicit destructive-operation confirmation.

Quick Start

Prerequisites: macOS 14+, Logic Pro 12.0.1+. GitHub Actions/Homebrew release assets are universal (arm64 + x86_64); historical local ADHOC prerelease cuts may still be arm64-only, so audit a specific tag via RELEASE-METADATA.json when needed.

Release note, 2026-06-09: v3.4.6 is the current stable GitHub Release. It ships ADHOC-signed universal artifacts when Apple Developer ID credentials are absent, plus SHA256SUMS.txt and RELEASE-METADATA.json for the fail-closed installer path.

Option A — Homebrew (recommended)

brew tap MongLong0214/logic-pro-mcp https://github.com/MongLong0214/logic-pro-mcp
brew install logic-pro-mcp

The Homebrew formula pins both the release tarball URL and its SHA256; Homebrew itself is a trusted delivery channel with its own signature chain. This is the hardened path for production installs.

Option B — Download-inspect-run one-line installer

The installer is fail-closed: it refuses to run without explicit LOGIC_PRO_MCP_SHA256 + LOGIC_PRO_MCP_TEAM_ID env pins. Inspect the script first, then execute with the pins copied from the release's SHA256SUMS.txt:

curl -fsSL https://raw.githubusercontent.com/MongLong0214/logic-pro-mcp/v3.4.6/Scripts/install.sh -o install.sh
# inspect install.sh, then:
LOGIC_PRO_MCP_SHA256=<paste from release SHA256SUMS.txt> \
LOGIC_PRO_MCP_TEAM_ID=<paste team_id from RELEASE-METADATA.json> \
bash install.sh

If you knowingly accept same-origin provenance (hash + Team ID fetched from the same release as the binary), opt in explicitly:

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

See SECURITY.md §Installer trust model for the trust tiers and threat model.

Either path installs the binary, verifies its SHA256, registers with Claude Code, and stages the Key Commands mapping reference (Logic 12.2+ does not auto-import; the reference assists Manual MIDI Learn — see Setup Guide §MIDIKeyCommands). It does not configure the MCU control surface or Scripter insert — see the Setup Guide for those two manual steps (~5 minutes).

Then test in Claude:

"Check Logic Pro MCP health and show all ready channels."

Expected: all 7 channels ready (or 5 if you skipped Key Commands and Scripter).

Architecture at a Glance

┌─ MCP Client (Claude / Desktop / Code) ─┐
│                                         │
│   logic_transport   logic_tracks        │
│   logic_mixer       logic_midi          │
│   logic_edit        logic_navigate      │
│   logic_project     logic_system        │
│                                         │
└─────────────────┬───────────────────────┘
                  │ stdio
┌─────────────────▼───────────────────────┐
│  LogicProMCP Server (Swift)             │
│                                         │
│  ┌─ ChannelRouter (130+ operations) ──┐ │
│  │  routes operation → best channel  │ │
│  └───────────────────┬───────────────┘ │
│                      │                  │
│  ┌──────┬──────┬─────▼─────┬──────┐    │
│  │ MCU  │ AX   │ AppleScript│CoreMIDI│ │
│  │      │      │            │        │ │
│  │ CGEvent      Scripter  KeyCmds   │ │
│  └──────┴──────┴───────────┴────────┘ │
│                      │                  │
└──────────────────────┼──────────────────┘
                       │ MIDI / AX / AppleScript
                ┌──────▼───────┐
                │   Logic Pro  │
                └──────────────┘

See Architecture for deeper details on channel priorities and state flow.

Documentation

DocumentAudiencePurpose
Setup GuideEnd usersOne-page install + Logic Pro integration, ~10 min
API ReferenceEnd users, MCP clientsAll 8 tools, 9 resources, 3 templates, 130+ operations
TroubleshootingEnd usersCommon failures and fixes
ArchitectureContributorsChannel design, state flow, testing strategy
Maintainer GuideMaintainersRelease, approvals, E2E checklist
Live Verify v3.4.6Maintainers, QALatest deterministic, coverage, release-build, packaging, and carried Logic Pro 12.2 issue-verification evidence
Security PolicySecurity reviewersThreat model, reporting, hardening
ChangelogEveryonePer-release changes
ContributingContributorsDev setup, PR workflow

Status

Current stable release: v3.4.6 is published (2026-06-09 KST). This is the evidence/packaging alignment release after the v3.4.5 Logic Pro 12.2 mixer verification work for Issues #10-#13. Verification: swift test --no-parallel at 1197/1197, swift build -c release, python3 -m py_compile Scripts/live-e2e-test.py, ruby -c Formula/logic-pro-mcp.rb, coverage 70.81% region / 78.32% line, strict live E2E 285/285 from the final current-main Logic 12.2 attestation, targeted live Logic Pro 12.2 checks for #10-#13, and GitHub Release workflow 27186085967 with build plus macOS 14/15 install validation all passed. Published release metadata is team_id:"ADHOC" / signing:"adhoc" / architectures:["x86_64","arm64"].

Active contracts (the things callers most care about)

  • Honest Contract envelope — every mutating op returns one of three states (State A confirmed, State B uncertain with reason, State C hard failure with error). Clients can switch on the envelope without parsing free-form text. See docs/HONEST-CONTRACT.md.
  • Fail-closed mutation targets — mixer faders, plugin params, marker delete/rename, track delete/duplicate require explicit track/index. Pre-v3.3.0 missing target silently mutated row 0; v3.3.0+ rejects with requires explicit '<param>'.
  • Target-faithful navigation — goto_marker returns element_not_found (State C) on a cold cache instead of advancing the marker pointer to "next." Caller must system.refresh_cache and retry, or supply a name.
  • 1-based MIDI channel — send_note / send_cc / record_sequence-notes-ch accept 1..16 (matches Logic's UI). Pre-v3.1.6 was 0-based.
  • Audit phase split — [AUDIT] project.<command> rejected | confirmation_required | executed distinguishes invalid calls, confirmation prompts, and actual route invocations. Pre-v3.4.0 emitted executed before validation.
  • Verified project saves — project.save_as no longer trusts a successful AppleScript return alone. It verifies that the target .logicx package exists and that an existing package's modification time advanced; stale or missing packages return State C readback_mismatch.
  • Constrained MIDI imports — logic_midi.import_file is exposed for sequenced import workflows, but only accepts a real .mid file that resolves under /tmp/LogicProMCP/ after symlink and traversal cleanup. Each successful import must create a new live AX track; otherwise it returns State C readback_mismatch.
  • Live project metadata — logic://project/info promotes live transport tempo/sample-rate when available, falls back per-field to saved project metadata, and does not pretend visible AX track rows are a full project track count.

Recent releases (one line each)

VersionDateHeadline
v3.4.62026-06-09Stable GitHub Release: evidence/packaging alignment after v3.4.5, version surfaces synced, final strict live E2E documented as complete, ADHOC universal artifacts, SHA256 metadata, and macOS 14/15 install validation
v3.4.52026-06-09Stable GitHub Release: Logic 12.2 mixer AX readback restored, echo-independent fader verification, mixer provenance, plugins_source:"ax" snapshots, guarded insert_plugin, ADHOC universal artifacts, SHA256 metadata, and deterministic/coverage/live/release-workflow evidence
v3.4.5-rc8..rc122026-06-05/08Release-workflow and installer-validation hotfix series: bash 3.2, split universal build, candidate stdout, Team ID parser validation, macOS 14 validation floor
v3.4.5-rc72026-06-05Release-workflow hotfix reroll, universal binary selection now scans all executable candidates under .build and picks the first real fat Mach-O
v3.4.5-rc52026-06-05Save/readback and MIDI import hardening, live project/info tier merge, ProcessUtils Logic detection fallback, Library duplicate-name column targeting, and final v4 MIDI-only composition E2E
v3.4.5-rc42026-05-10Installer metadata parser fix — same-origin install path now reads team_id from one-line RELEASE-METADATA.json
v3.4.5-rc32026-05-10CI green, but superseded by rc4 because same-origin installer metadata parsing selected version instead of team_id
v3.4.5-rc22026-05-10CI gate aligned to deterministic swift test --no-parallel; superseded by rc3 due transport packet-sink recorder race in CI
v3.4.5-rc12026-05-10Strict live E2E parent-context closure — shell-owned tmux transport, long JSON-RPC PTY hardening, 259/259 live checks passing
v3.4.42026-05-09CI hotfix — MIDIClientCreate(-50) smoke-test skip on macos-15-arm64 (sandboxed runner has no CoreMIDI server)
v3.4.32026-05-09CI Coverage step find-based path resolution + diagnostic output
v3.4.22026-05-08ProjectAuditPhaseTests parallel-execution race fix (NSLock + @Suite(.serialized))
v3.4.12026-05-08Boomer P2 sweep — fail-loud lipo parsing, audit-phase contract docstring, ci.yml awk validation, uninstall-keycmds.sh empty-backup guard
v3.4.02026-05-08Enterprise deferred-blocker closure (8/9): stdio launch parity (RB-2), release-workflow notarization gate (RB-4), install/uninstall non-TTY safety (RB-6), audit-phase split (H-1, BREAKING), goto_marker target-faithful (H-2, BREAKING), docs drift, CI coverage gate re-armed, AXValue force-cast hardening
v3.3.02026-05-08Enterprise P0 closure: mixer/marker fail-closed (BREAKING), track.duplicate State-A verified gate (BREAKING), signal-cleanup contract (SIGTERM/SIGINT → coordinated shutdown), live-e2e-test.py false-positive expectation removed
v3.2.02026-05-07Marker position_source provenance surfaced in resource extras; sub-bar nav accuracy honestly deferred to v3.3 (T0 live spike found Logic 12.2 dialog is a 4-segment AXSlider)
v3.1.112026-05-07Logic 12.2 marker parser strict 4-component, 13-locale menu paths, lenient 1–3 component policy removed (Issue #9)
v3.1.62026-05-04port: "keycmd" routing for logic_midi.send_*, 1-based MIDI channel (BREAKING), audited coverage matrix (Issue #1)
v3.1.02026-04-25Honest Contract introduced (resource envelope BREAKING)

Per-release detail: CHANGELOG.md.

Distribution

Stable production tags use the GitHub Actions release workflow; the published RELEASE-METADATA.json records the signing mode, Team ID, and architectures for the exact artifact. When Developer ID credentials are absent, stable and prerelease tags publish ADHOC artifacts with team_id:"ADHOC". SHA256 pinning is mandatory for the fail-closed installer path. v3.4.6 is published as a stable ADHOC release with build and macOS 14/15 install validation in workflow 27186085967. See SECURITY.md §Release types.

Testing

  • 1208 unit + integration tests on current main — swift test --no-parallel PASS. Coverage spans Honest Contract envelopes, fail-closed mutation gates (mixer/marker/MIDI import), routing-audit invariants, AX hardening, LogicProjectFileReader plist parsing + path validation, live project/info tier-merge, project.save_as package-mtime readback, LogicProServer.stop() signal-cleanup contract, deterministic transport packet-sink capture, installer metadata parsing, mixer AX readback, plugin-slot snapshots, guarded insert-plugin flow, and release/CI contract guards.
  • Live E2E (Scripts/live-e2e-test.py) defaults to the release binary. Protocol/security/validation assertions run on any host; Logic/CoreMIDI-dependent checks skip unless a live Logic Pro session is detected. For attestation runs, use LOGIC_PRO_MCP_STRICT_LIVE=1 Scripts/live-e2e-test.sh; the shell wrapper launches the MCP server under a trusted tmux parent so macOS TCC evaluates the same stdio parent context instead of Python. Current strict attestation: 285 passed, 0 skipped, 0 failed.
  • Current live Logic Pro 12.2 validation — .build/release/LogicProMCP launched cleanly, health reported all 7 channels ready, #10 set_volume verified via AX readback despite missing MCU echo, #11 logic://mixer refreshed from AX poll, #12 plugins[] carried plugins_source:"ax", and #13 guarded insert_plugin verified the inserted Gain slot and refused an occupied slot. Fresh strict coverage: full live E2E plus targeted #10-#13 checks all passed.
  • CI coverage gate — hard gate region ≥ 70%, line ≥ 78%, with an explicit line ≥ 90% target reported as advisory until the dedicated coverage-uplift work lands. Latest local coverage is 73.62% region / 81.06% line. The coverage job now fails closed on LLVM profile write errors instead of letting default.profraw runtime errors pass as warning noise.
  • CoreMIDI smoke tests skip on macos-15-arm64 GitHub runners (MIDIClientCreate returns -50 in the sandboxed image; production code path coverage on real macOS hosts is unchanged).

Known limitations

  • transport.set_tempo typed-entry path falls back to slider increment (10-BPM granularity) when Logic's tempo display can't accept text input. Set tempo manually in Logic once before relying on MCP tempo operations for sub-10-BPM precision.
  • record_sequence regions start at bar 1 and extend to the target bar (padding-CC strategy). Note timing inside the region is exact; the leading padding is inaudible but cosmetic. Trim after import via Logic's Edit → Trim menu if a tight region matters.
  • MIDIKeyCommands channel — Logic 12.2 doesn't accept the legacy .plist Key Commands import (the menu item is grayed out). The bundled keycmd-preset.plist is staged as a Manual MIDI Learn reference; eight ops are effectively keycmd-only and require a one-time MIDI Learn binding. See docs/SETUP.md §4 for the audited coverage matrix.
  • Marker list resource (logic://markers) returns [] honestly when Logic 12.2's Marker List window is closed — Apple removed the AXRuler role from the arrange window subtree on 12.2, and user markers now live exclusively in that window's AXTable. Auto-open is intentionally not shipped (would change focus without consent); track an opt-in via the issue tracker if you'd like it.

License

MIT. See LICENSE.

Contributing

Bug reports, PRs, and feature discussions are welcome. See CONTRIBUTING.md for the dev workflow.

Security vulnerabilities: please do not open a public issue. See SECURITY.md for the private disclosure process.

Ver o original no GitHub

Bom para

Relacionados