local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Enables parsing and manipulation of MIDI files, including reading file information, modifying tracks, notes, control changes, and pitch bends, setting tempo, and adding new elements to MIDI files.
Provides the runtime environment for the MCP server, allowing it to execute MIDI file operations through the Tone.js library and its MIDI parsing capabilities.
Archivo MIDI MCP
📖 Introducción
Esta herramienta de análisis y manipulación de archivos MIDI se basa en Tone.js y la biblioteca @tonejs/midi, y ofrece funcionalidad mediante servicios MCP (Protocolo de Contexto de Modelo). Esta herramienta permite leer, analizar y modificar archivos MIDI fácilmente sin necesidad de profundizar en las complejidades del formato.
✨ Características
- Leer información del archivo MIDI
- Obtener y modificar información de pistas, notas, cambios de control y pitch bend
- Establecer el tempo del archivo MIDI (BPM)
- Agregue nuevas notas, controle cambios y cambios de tono a pistas específicas
- Añadir nuevas pistas
- Manejo integral de errores
📥 Requisitos previos
- Instalar Node.js : Asegúrese de que el comando npx se ejecute correctamente. Se recomienda instalar la última versión estable desde el sitio web oficial de Node.js.
🔧 Uso
Úselo con un cliente MCP. Los clientes compatibles incluyen, entre otros:
- Cursor
- Estudio Cherry
- Escritorio de Claude
Ejemplo de configuración del cursor
Configurar midi-file-mcp en Cursor:
🎹 Uso del analizador MIDI MCP con rutas absolutas
Todas las operaciones en MIDI Parser MCP requieren la ruta absoluta del archivo MIDI. Esto garantiza que la herramienta pueda localizar y manipular correctamente sus archivos MIDI, independientemente del directorio de trabajo actual.
Ejemplos de indicaciones
A continuación se muestran algunos ejemplos de indicaciones que puedes utilizar con tu asistente de IA:
- Obtener información del archivo MIDI :Copy
- Analizando pistas :Copy
- Ajuste del tempo :Copy
- Trabajar con notas :Copy
- Agregar notas :Copy
Operaciones disponibles
| Operación | Descripción | Parámetros |
|---|---|---|
| obtener información midi | Obtener información general del archivo MIDI | ruta de archivo |
| establecer_tempo | Establecer el tempo (BPM) de un archivo MIDI | ruta de archivo, bpm |
| obtener información de pistas | Obtenga información sobre todas las pistas | ruta de archivo |
| obtener_información_de_pista_por_índice | Obtener información sobre una pista específica | ruta de archivo, índice de pista |
| obtener_notas_por_índice | Obtener todas las notas de una pista específica | ruta de archivo, índice de pista |
| obtener_bends_de_tono_por_índice | Obtener todos los pitch bends de una pista específica | ruta de archivo, índice de pista |
| obtener_cambios_de_control_por_índice | Obtener todos los cambios de control de una pista específica | ruta de archivo, índice de pista |
| agregar notas por índice | Agregar notas a una pista específica | ruta de archivo, índice de pista, notas |
| añadir_cambios_de_control_por_índice | Agregar cambios de control a una pista específica | ruta de archivo, índice de seguimiento, cambios de control |
| añadir_bends_de_tono_por_índice | Agregar cambios de tono a una pista específica | ruta de archivo, índice de pista, pitchbends |
| añadir pista | Agregar una nueva pista al archivo MIDI | ruta de archivo |
Nota : utilice siempre barras invertidas dobles ( \\ ) o barras diagonales ( / ) en las rutas de archivos cuando trabaje con rutas de Windows para evitar errores.
📄 Licencia
Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.
🙏 Agradecimientos
Gracias a los siguientes proyectos y bibliotecas, sin los cuales esta herramienta no sería posible:
- Tone.js - Marco de audio web
- @tonejs/midi - Biblioteca de análisis y manipulación de archivos MIDI
- MCP (Protocolo de contexto de modelo) : permite la integración de herramientas en asistentes de IA
You must be authenticated.
Tools
Una potente herramienta MCP para analizar y manipular archivos MIDI que permite a los usuarios leer, analizar y modificar archivos MIDI a través de comandos de lenguaje natural, admitiendo operaciones como leer información de archivos, modificar pistas, agregar notas y configurar el tempo.