Logic Pro MCP Server para Claude, Cursor y Agentes de IA

Un servidor local del Protocolo de Contexto de Modelo (MCP) que permite a Claude Code, Claude Desktop, Cursor, VS Code y agentes de IA personalizados controlar Logic Pro para la producción musical con IA: crear pistas, escribir MIDI, operar el estado del transporte y el mezclador, inspeccionar datos de proyectos en vivo y verificar resultados.

Instalación · Ver demo · Qué controla

🏆 Seleccionado para el programa Claude for Open Source de Anthropic

Logic Pro MCP ha sido seleccionado oficialmente para el programa Claude for Open Source de Anthropic — un reconocimiento de los creadores de Claude de que este proyecto es un trabajo de código abierto que vale la pena apoyar. Este servidor está construido con Claude, para agentes impulsados por Claude — y ahora cuenta con el apoyo oficial del programa.

Logic Pro MCP Server ofrece a Claude, Cursor y agentes de IA personalizados una forma estructurada de controlar Logic Pro sin macros de teclado frágiles. Logic Pro no incluye una API de primera parte para composición agéntica, configuración de sesión, operaciones de mezclador o lectura de proyectos en vivo, por lo que Logic Pro MCP llena ese vacío combinando 7 canales de control nativos de macOS detrás de una interfaz MCP, y luego envuelve cada operación de alto riesgo en contratos explícitos de estado, confirmación y verificación.

El resultado no es "automatización de pantalla con indicaciones". Es un servidor estructurado para agentes de DAW: las herramientas mutan, los recursos leen, la evidencia está etiquetada y los resultados inciertos permanecen inciertos en lugar de informarse como éxito.

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.

De un vistazo

Si este proyecto te ayuda a hacer música con Claude, Cursor o cualquier cliente MCP, dale una estrella al repositorio. Ayuda al proyecto a llegar a más usuarios y mantenedores de Logic Pro.

¿Quieres contribuir? Empieza con la Guía de contribución y los issues abiertos. Muchos documentos, ejemplos, pruebas de validación y mejoras de mensajes de CLI no requieren Logic Pro.

Related MCP server: Logic Pro MCP Server

Por qué existe

La mayoría de los intentos de automatización de Logic Pro caen en una de tres trampas:

1. Recetas solo de prompts que se alejan de la superficie real de la herramienta.

2. Automatización con macros de teclado que puede hacer clic en el objetivo equivocado y aun así parecer exitosa.

3. Control de un solo canal que puede escribir en Logic pero no puede leer de forma fiable lo que Logic realmente hizo.

Logic Pro MCP utiliza un modelo diferente. Enruta cada operación al canal más fuerte disponible, expone el estado en vivo a través de los recursos de MCP y obliga a los llamadores a gestionar tres resultados: confirmado, incierto o fallido.

Qué controla

Superficies de nivel agente

Las herramientas son para acciones y comprobaciones de artefactos locales. La superficie de escritura pública es intencionalmente pequeña: logic_transport, logic_tracks, logic_mixer, logic_plugins, logic_midi, logic_edit, logic_navigate, logic_project y logic_system. logic_audio es de solo lectura y verifica los archivos exportados después de que Logic los escribe.

Los recursos son para el estado. Los clientes deben leer logic://transport/state, logic://tracks, logic://mixer, logic://project/info, logic://project/audit, logic://project/cleanup-plan, logic://midi/ports y recursos relacionados en lugar de gastar llamadas de herramientas en sondeos.

La evidencia está separada de las afirmaciones. El README apunta a evidencia de lanzamiento, verificación actual de main y artefactos multimedia en vivo en lugar de implicar que un comando exitoso equivale a un estado verificado de Logic.

Modelo de confianza

• Sobres de contrato honesto: las operaciones de mutación devuelven Estado A confirmado, Estado B incierto con una razón, o Estado C fallido con un error.

• Aplicación de plugins verificada: logic_plugins.* usa HC v2 (hc_schema: 2) y devuelve Estado A solo después de que la identidad del proyecto, la pista objetivo, la ranura de inserción física, la identidad del plugin y la lectura coincidan.

• Objetivos de fallo seguro: las operaciones peligrosas de mezclador, marcadores, pistas, importación MIDI y plugins requieren objetivos explícitos y validación.

• Niveles de confirmación: los flujos destructivos/de proyecto y de inserción de plugins requieren metadatos de confirmación explícitos antes de la ejecución.

• Etiquetas de procedencia: las superficies de lectura exponen etiquetas de fuente, frescura y evidencia en lugar de obligar a los clientes a adivinar.

• Refuerzo del instalador: Homebrew fija SHA256; el instalador de shell se niega a ejecutarse sin fijaciones explícitas de hash/equipo a menos que se permita explícitamente la procedencia del mismo origen.

• Honestidad de lanzamiento: la v3.13.0 publicada es la línea de instalación estable actual, y las afirmaciones del README permanecen vinculadas a artefactos publicados, pruebas del árbol de lanzamiento o evidencia en vivo explícitamente enlazada.

Inicio rápido

Requisitos previos: macOS 14+ para el servidor MCP, Logic Pro (la versión más reciente tiene prioridad — actualmente 12.3, que Apple lista como requisito de macOS 15.6+; las versiones anteriores de Logic hasta el mínimo de 12.0.1 son de mejor esfuerzo), y un cliente MCP que pueda lanzar un servidor stdio. Los artefactos publicados de GitHub Actions/Homebrew son universales (arm64 + x86_64) y no requieren Xcode. Bounce/exportación usa el helper CGEvent nativo incluido sin binario de clic de terceros.

Política de versiones de Logic Pro. Logic Pro MCP sigue la versión más reciente de Logic Pro como su objetivo de primera clase y la valida (las pruebas E2E estrictas en vivo se ejecutan en Logic Pro 12.3). Cuando Apple lanza una nueva versión de Logic Pro, darle soporte es la máxima prioridad — el árbol de Accesibilidad/UI cambia entre versiones, así que la versión más nueva es donde llegan primero las correcciones. Las versiones anteriores por encima del mínimo de 12.0.1 siguen siendo de mejor esfuerzo y pueden perder paridad a medida que cambian esas superficies de UI.

El manifiesto del paquete usa Swift tools 6.0 para compatibilidad. La verificación actual del código fuente usa Xcode 16.4 / Swift 6.2 en CI.

La versión estable publicada actual es v3.13.0 (2026-07-22 UTC). Incluye artefactos universales firmados ADHOC cuando no hay credenciales de Apple Developer ID, además de SHA256SUMS.txt y RELEASE-METADATA.json para instalaciones fijadas. La superficie de ejecución pasa a ser 10 herramientas / 18 recursos / 12 plantillas de recursos — el catálogo de operaciones de solo lectura generado logic://system/operations se incluye como la 12.ª plantilla. Titulares: la campaña de actuación sin coordenadas (mute/solo/arm, elementos del menú de la app, selección de regiones usan acciones AX y comandos de teclado con verificación de efecto observado; el fallback de herramienta de clic externa está retirado), configuración automática de comando de teclado para arm de grabación con consentimiento (system.setup_arm_key), un clasificador de modales independiente de locale (los editores de plugins localizados y el panel Smart Controls de Drummer ya no bloquean operaciones no relacionadas, mientras que los modales genuinos siguen bloqueando), comportamiento del kernel ADR activado por defecto (target_ref estable por sesión, registro de contratos de operación con parámetros estrictos, preflight de saga de mutación verificada, traza de operación), rutas de borrado de traza/soporte endurecidas con SecureFD con plazo de vida de saga acotado, y la corrección del empaquetado de Homebrew que restaura bounce/exportación (logic_variants.py ahora se incluye — #427). Mantiene las adiciones de capacidades MCP de v3.9.0 (transport.toggle_autopunch, suscripciones a recursos, prompts de flujo de trabajo, outputSchema / structuredContent por herramienta), la corrección de ventana cerrada de plugin verificado de v3.9.2, y el enfoque de escritorio/Creator Studio de v3.10.0. Las dos superficies solo en vivo de v3.9.0 (lectura de exportación MIDI, parámetros verificados de Channel EQ) siguen diferidas honestamente con evidencia de spike.

1. Instalar

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

La fórmula de Homebrew fija tanto la URL del tarball de lanzamiento como su SHA256; Homebrew en sí es un canal de entrega confiable con su propia cadena de firmas. Este es el camino endurecido para instalaciones de producción. (En Homebrew anterior a 6.0 el paso brew trust no existe — omítelo.)

Para desarrollo en el árbol de código fuente, compila localmente:

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

2. Registrar con un cliente MCP

Claude Code:

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

Configuración genérica de cliente MCP:

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

Si compilaste desde el código fuente, apunta el comando a .build/release/LogicProMCP.

3. Completar la configuración de Logic Pro

Ejecuta las comprobaciones locales:

LogicProMCP --check-permissions

Luego completa los dos pasos de configuración en Logic en docs/SETUP.md:

• Registra la superficie de control MCU LogicProMCP-MCU-Internal.

• Añade el insert Scripter incluido si necesitas escrituras de parámetros de plugins.

Logic 12.2+ no importa automáticamente el plist de Key Commands heredado; el preset incluido se prepara como referencia de Manual MIDI Learn.

4. Probar desde tu agente

Pide al cliente:

Comprueba el estado de Logic Pro MCP y muestra todos los canales listos.

Esperado: los 7 canales ready después de la configuración completa, o 5 si omitiste intencionalmente Key Commands y Scripter.

Instalador de shell fijado

El instalador es de fallo seguro: se niega a ejecutarse sin fijaciones explícitas de entorno LOGIC_PRO_MCP_SHA256 + LOGIC_PRO_MCP_TEAM_ID. Verifica el archivo descargado LogicProMCP-macOS-universal.tar.gz, así que copia el SHA de esa entrada del archivo en el SHA256SUMS.txt del lanzamiento:

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

Si aceptas conscientemente la procedencia del mismo origen (hash + Team ID obtenidos del mismo lanzamiento que el binario), opta explícitamente:

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

Consulta SECURITY.md §Modelo de confianza del instalador para los niveles de confianza y el modelo de amenazas.

Doctor de configuración

Conseguir que un agente maneje Logic Pro de forma fiable es principalmente un problema de permisos y entorno: concesiones TCC, la versión correcta de Logic, un documento en vivo, una superficie de control registrada, sin modales bloqueantes. LogicProMCP doctor es una plataforma de preparación de primera clase, consciente de la intención, construida exactamente para esto — no una comprobación booleana de "está instalado", sino un diagnóstico que te dice qué capacidades están listas, cuáles están bloqueadas, por qué y qué hacer a continuación — y nunca informa verde para algo que no pudo verificar realmente.

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

Perfiles conscientes de la intención. No te obligan a pasar comprobaciones que nunca usarás. --profile limita el conjunto requerido a cómo manejas realmente Logic — core (transporte/pistas/AX), mixer, keycmd, legacy-scripter o full. --client (claude-code, claude-desktop, cursor, vscode, terminal, custom) añade las comprobaciones de registro que importan para ese host. El estado agregado se limita a las comprobaciones requeridas del perfil seleccionado, así que un flujo de trabajo solo MCU no se marca como no saludable por una brecha de Scripter que nunca encontrará.

Preparación de capacidades, no solo aprobado/fallido de comprobaciones. Cada comprobación está mapeada a las capacidades que habilita (track_management, midi_import, mixer_ax, mixer_mcu, keycmd_only_ops, verified_plugin_applyback, project_lifecycle, …). El informe te dice "la importación MIDI está lista; la aplicación de plugins verificada está bloqueada por PostEvent" — el lenguaje sobre el que un agente (o un operador) puede actuar directamente.

Cadena causal — fix_plan y blocked_by. Los fallos se ordenan en un fix_plan (las siguientes acciones, primero las que más desbloquean), y cada comprobación posterior nombra la comprobación anterior que la blocked_by — así arreglas la raíz, no el síntoma. El headline reformula la única siguiente acción.

La honestidad es el punto central. Una comprobación que no pudo ejecutarse (capacidad ausente, base de datos TCC ilegible) se notifica explícitamente como skipped con un motivo; nunca se integra silenciosamente en un aprobado. Los saltos intencionales (--skip-channel <MIDIKeyCommands|Scripter> con un --skip-note opcional, p. ej. si deliberadamente no registraste Scripter) se registran y se excluyen de la preparación sin simular un verde. Los hallazgos de TCC se redactan a resúmenes de servicio/principal/estado; no hay rutas locales sin procesar en el informe.

Superficie de permisos que verifica. --check-permissions agrupa las cuatro concesiones de TCC que necesita un agente real y sale con código distinto de cero si falta alguna: Accesibilidad, Automatización → Logic Pro, Automatización → Eventos del sistema (un destino separado: que Logic esté concedido no implica este) y PostEvent (monitorización de entrada, requerida por el respaldo de rebote/clic de CGEvent). El doctor trata estas como capacidades distintas porque fallan de forma independiente: p. ej. un -1743 / errAEEventNotPermitted de Eventos del sistema es una brecha de permiso del lanzador (al proceso responsable de lanzar el servidor se le deniega Automatización → Eventos del sistema), notificada como tal con la corrección exacta, no atribuida erróneamente a Logic.

Códigos de salida estrictos (--strict, para CI/control de agentes): 0 correcto · 1 fallido · 2 manual_action_required · 3 degradado. Los códigos 2/3 son códigos de estado, no errores de uso, y se sitúan por debajo del rango de sysexits.h.

Una ejecución real (redactada) en un equipo a mitad de configuración:

{
  "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" } /* … */ ]
}

La misma ejecución en un terminal imprime un informe agrupado y codificado por colores con anclas de corrección por comprobación en docs/SETUP.md. La referencia completa de banderas y la corrección de cada comprobación viven en docs/SETUP.md; los bytes de --json son un contrato estable contra el que puedes hacer aserciones en tu propia automatización de incorporación.

Arquitectura de un vistazo

Los clientes MCP lanzan el servidor stdio de Swift. Los despachadores validan los parámetros de las herramientas, ChannelRouter elige el canal macOS más robusto disponible, los recursos exponen estado en caché/en vivo, y las escrituras de alto riesgo devuelven envoltorios explícitos confirmed/uncertain/failed. Los canales principales son MCU, Accessibility, AppleScript, CoreMIDI, CGEvent, Scripter y MIDI Key Commands.

Documentación

El árbol de documentación pública está acotado intencionadamente: configuración, API, solución de problemas, medios del README, además de PRD/incidencias públicas que explican remediaciones visibles para el usuario, activas o publicadas. Las notas de versión históricas, los PRD internos, los tableros de incidencias privados, las notas de picos y los archivos de trabajo locales de evidencia en vivo se mantienen fuera de docs/; el historial público de versiones pertenece a CHANGELOG.md, GitHub Releases, los PR fusionados y el historial de incidencias.

Estado

Estable publicado: v3.13.0 está disponible como GitHub Release e instalación Homebrew. Incluye el conjunto acumulado de v3.6.0 -> v3.11.0, restaura el rebote/exportación de Homebrew empaquetando logic_variants.py con una puerta de liberación de cierre de importación (#427), publica la campaña de actuación sin coordenadas y la configuración automática de arm con consentimiento (#413), corrige la clasificación errónea de modales en editor localizado/Smart Controls (#381, #405), y activa el comportamiento de kernel ADR-002/003/004/005 por defecto con endurecimiento SecureFD/saga (#417, #412). Los metadatos publicados permanecen team_id:"ADHOC" / signing:"adhoc" cuando no hay credenciales de Developer ID, con artefactos universales x86_64 + arm64 producidos por GitHub Actions.

Estable anterior: v3.10.0 sigue disponible como la versión de soporte de Creator Studio; v3.9.2 sigue disponible como la versión de corrección verificada de escritura de parámetros de plugins; v3.9.1 y anteriores siguen disponibles para instalaciones fijadas.

Verificación

El E2E en vivo usa por defecto el binario de versión. Las aserciones de protocolo/seguridad se ejecutan en cualquier host; las comprobaciones dependientes de Logic/CoreMIDI se omiten a menos que haya una sesión real de Logic Pro visible. El modo estricto convierte los saltos limitados a en vivo en fallos, trata la ausencia de estado de proyecto como una condición previa fallida de ciclo de ida y vuelta, y lanza el servidor MCP bajo un padre de shell/tmux de confianza para que TCC de macOS evalúe el mismo contexto padre que usan los flujos de clientes en vivo.

Contratos de API que importan

• Honest Contract envelope — cada operación mutadora devuelve Estado A confirmado, Estado B incierto con reason, o Estado C fallo grave con error. Ver docs/API.md.

• HC v2 plugin apply-back — logic_plugins.get_inventory, set_param_verified e insert_verified añaden state + hc_schema: 2; el Estado C siempre lleva verified:false, write_attempted, seguridad de reintento e identidad del objetivo cuando corresponde.

• Objetivos de mutación fail-closed — los faders del mezclador, los parámetros de plugin, el borrado/renombrado de marcadores, el borrado/duplicado de pistas y las importaciones MIDI requieren parámetros de objetivo explícitos.

• Inserción de plugin en ranura exacta — logic_plugins.insert_verified apunta al índice de inserción física devuelto por get_inventory, verifica que el popup esté anclado a esa ranura y confirma el éxito solo mediante la diferencia de inventario posterior a la escritura.

• Navegación fiel al objetivo — goto_marker devuelve element_not_found con una caché fría en lugar de avanzar al siguiente marcador.

• Canal MIDI basado en 1 — los valores ch de send_note, send_cc y record_sequence aceptan 1..16 para coincidir con la interfaz de Logic.

• SysEx crudo acotado — send_sysex rechaza cargas útiles de más de 1024 bytes antes del enrutamiento CoreMIDI.

• Protecciones de bounce audible — record_sequence rechaza importaciones no verificadas de GM Device / External MIDI, logic://project/audit marca las pistas External MIDI con regiones MIDI como bloqueadores de exportación, y logic_project.bounce rechaza esos bloqueadores antes de abrir el diálogo de Bounce.

• División de fases de auditoría — los registros de auditoría distinguen llamadas rechazadas, avisos de confirmación e invocaciones de ruta ejecutadas.

• Guardados de proyecto verificados — project.save_as verifica que el paquete .logicx de destino exista y que los paquetes existentes avancen la hora de modificación.

• Metadatos de proyecto en vivo — logic://project/info promueve el tempo/frecuencia de muestreo del transporte en vivo cuando están disponibles y recurre por campo a los metadatos guardados del proyecto.

• Lecturas sin efectos secundarios — los recursos exponen estado, metadatos e inventario en caché sin mutar Logic.

Lanzamiento y distribución

Las etiquetas de producción estables usan el flujo de trabajo de lanzamiento de GitHub Actions. RELEASE-METADATA.json registra el modo de firma exacto, el Team ID y las arquitecturas de cada artefacto. Cuando no hay credenciales de Developer ID, los lanzamientos publican artefactos ADHOC con metadatos SHA256 y validación de instalación en lugar de pretender estar notarizados.

El detalle por lanzamiento se encuentra en CHANGELOG.md. Los niveles de confianza de seguridad e instalador están documentados en SECURITY.md.

Metadatos del registro

El repositorio incluye server.json para la ruta oficial de metadatos del MCP Registry. Está fijado a la versión estable actual (v3.13.0) y lleva etiquetas de descubrimiento para Logic Pro, automatización DAW, MIDI, clientes MCP de Claude/Cursor y agentes de producción musical. El registro es solo de metadatos porque el esquema de paquetes del registry aún no modela fórmulas de Homebrew ni tarballs de lanzamiento de GitHub como tipos de paquete de primera clase. La autoridad de instalación sigue siendo la ruta fijada de GitHub Release/Homebrew anterior.

Limitaciones conocidas

• Escritura de tempo: transport.set_tempo usa respaldos acotados de slider AX grueso y exacto cuando la entrada de tempo en línea de Logic no se confirma, y falla de forma cerrada si la lectura exacta aún no puede verificarse.

• Relleno de regiones MIDI: las regiones de record_sequence comienzan en el compás 1 y se extienden hasta el compás objetivo usando relleno inaudible; el tiempo de las notas dentro de la región es exacto, pero la región puede parecer más larga que la frase.

• Disponibilidad de bounce MIDI externo: las regiones MIDI en pistas GM Device / External MIDI no se aceptan como evidencia de bounce audible por la auditoría de proyecto ni por logic_project.bounce. Mueve o recrea el material en pistas de Software Instrument antes de reclamar un Logic Bounce verificado.

• MIDI Key Commands: Logic 12.2 no acepta la importación heredada de Key Commands .plist; el MIDI Learn manual sigue siendo necesario para operaciones solo de keycmd.

• Marcadores: la creación de marcadores usa el menú Navigate nativo de Logic y verifica la Marker List cuando es legible. Una Marker List cerrada/ilegible se informa como ilegible o se sirve desde la última caché legible en lugar de promoverse a una lista vacía verificada. rename_marker sigue siendo not_implemented.

• Lectura de parámetros de plugin: logic_plugins.set_param_verified abre la ventana del plugin de la inserción objetivo cuando es necesario y verifica en vivo el threshold del Compressor a través de esa ventana; los parámetros arbitrarios de plugin siguen siendo trabajo futuro y fallan de forma cerrada con unsupported_param_readback.

Desarrollo

Las compilaciones desde el código fuente requieren Xcode 16.4+ / Swift 6.2 para la cadena de herramientas verificada actual.

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

Para atestación en vivo en un host Logic Pro configurado:

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

Licencia

MIT. Ver LICENSE.

Contribuciones

Los informes de errores, PRs y discusiones de funciones son bienvenidos. Ver CONTRIBUTING.md y los issues abiertos para el flujo de trabajo de desarrollo.

Vulnerabilidades de seguridad: por favor, no abras un issue público. Ver SECURITY.md para el proceso de divulgación privada.