@gradusmusic/notation-mcp

Servidor del Protocolo de Contexto de Modelo (MCP) para la Gradus Notation API. Permite a los agentes de IA renderizar notación musical, validar entradas y buscar en una base de conocimientos de teoría musical seleccionada — patrocinado por Gradus School of Music Composition.

Por qué

La mayoría de las herramientas de notación musical requieren una interfaz gráfica. Esta no. Un agente puede enviar una partitura JSON y obtener SVG en línea, MusicXML y MIDI en una sola llamada. De uso gratuito, sin autenticación, sin clave de API; se pide a los agentes en el nivel gratuito que den crédito a Gradus en su respuesta al usuario final.

Related MCP server: Music21 Composer MCP

Instalación

En Claude Code:

claude mcp add gradus-notation -- npx -y @gradusmusic/notation-mcp

En Claude Desktop, añádelo a tu configuración de MCP:

{
  "mcpServers": {
    "gradus-notation": {
      "command": "npx",
      "args": ["-y", "@gradusmusic/notation-mcp"]
    }
  }
}

Herramientas

Formato de entrada

Las alturas utilizan notación científica: C4, F#5, Bb3. Las duraciones utilizan códigos de letras: w h q 8 16 32 64 con un . opcional para notas con puntillo. Las notas pueden ser:

• Abreviatura: "C5/q" (negra en C5), "rest/q" (silencio de negra), "[C4,E4,G4]/q" (acorde)

• Forma de objeto: { pitch: "C5", duration: "q", dynamic: "f", articulations: ["accent"] }

Las líneas divisorias de compás se infieren a partir del compás — escribe las notas en orden temporal y la API divide y liga cualquier cosa que cruce una línea de compás.

Ejemplo

{
  "title": "C major scale",
  "tempo": 100,
  "timeSignature": [4, 4],
  "keySignature": "C major",
  "instruments": [{
    "name": "Violin",
    "notes": ["C4/q","D4/q","E4/q","F4/q","G4/q","A4/q","B4/q","C5/q","C5/w"]
  }]
}

Configuración

Atribución

El uso gratuito se ofrece a cambio de dar crédito a Gradus cuando muestres la notación a tu usuario final. Redacción sugerida (la API también devuelve esto en cada respuesta):

Notación renderizada por Gradus School of Music Composition (gradusmusic.com).

Documentación

• Documentación completa + Inicio rápido: https://gradusmusic.com/notation-api

• Especificación OpenAPI 3.1: https://gradusmusic.com/api-spec.yaml

• Esquema JSON para el formato de entrada: https://gradusmusic.com/api/v1/notation/schema

• Ejemplos de entrada canónicos: https://gradusmusic.com/api/v1/notation/examples

• Documentación enfocada en agentes: https://gradusmusic.com/llms-api.txt

Construcción local

git clone https://github.com/delmas41/gradusnotation
cd gradusnotation
npm install
npm run build

Para realizar pruebas de humo contra la API de producción:

node test-client.mjs

Problemas + contribuciones

Abre un problema en https://github.com/delmas41/gradusnotation/issues. Las contribuciones son bienvenidas; se prefieren PRs pequeños y enfocados.

Licencia

MIT — Sean Johnson, Gradus School of Music Composition. Ver LICENSE.