@gradusmusic/notation-mcp

Model Context Protocol-Server für die Gradus Notation API. Ermöglicht KI-Agenten das Rendern von Musiknotation, die Validierung von Eingaben und die Suche in einer kuratierten Wissensdatenbank für Musiktheorie — gesponsert von der Gradus School of Music Composition.

Warum

Die meisten Musiknotations-Tools erfordern eine grafische Benutzeroberfläche. Dieses nicht. Ein Agent kann eine JSON-Partitur übermitteln und erhält in einem einzigen Aufruf Inline-SVG, MusicXML und MIDI zurück. Kostenlose Nutzung, keine Authentifizierung, kein API-Schlüssel — Agenten im kostenlosen Tarif werden gebeten, Gradus in ihrer Antwort an den Endbenutzer zu erwähnen.

Related MCP server: Music21 Composer MCP

Installation

In Claude Code:

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

In Claude Desktop, fügen Sie dies zu Ihrer MCP-Konfiguration hinzu:

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

Tools

Eingabeformat

Tonhöhen verwenden die wissenschaftliche Notation: C4, F#5, Bb3. Dauern verwenden Buchstabencodes: w h q 8 16 32 64 mit optionalem . für punktierte Noten. Noten können sein:

• Kurzschreibweise: "C5/q" (Viertel C5), "rest/q" (Viertelpause), "[C4,E4,G4]/q" (Akkord)

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

Taktstriche werden aus der Taktart abgeleitet — schreiben Sie Noten in zeitlicher Reihenfolge, und die API teilt und verbindet alles, was einen Taktstrich überschreitet.

Beispiel

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

Konfiguration

Namensnennung

Die kostenlose Nutzung wird im Austausch für die Nennung von Gradus angeboten, wenn Sie dem Endbenutzer Notation präsentieren. Empfohlene Formulierung (die API gibt dies auch in jeder Antwort zurück):

Notation gerendert von der Gradus School of Music Composition (gradusmusic.com).

Dokumentation

• Vollständige Dokumentation + Schnellstart: https://gradusmusic.com/notation-api

• OpenAPI 3.1 Spezifikation: https://gradusmusic.com/api-spec.yaml

• JSON-Schema für das Eingabeformat: https://gradusmusic.com/api/v1/notation/schema

• Kanonische Eingabebeispiele: https://gradusmusic.com/api/v1/notation/examples

• Agenten-fokussierte Dokumentation: https://gradusmusic.com/llms-api.txt

Lokal bauen

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

Für einen Smoke-Test gegen die Produktions-API:

node test-client.mjs

Probleme + Beiträge

Eröffnen Sie ein Issue unter https://github.com/delmas41/gradusnotation/issues. Beiträge sind willkommen — kleine, fokussierte PRs werden bevorzugt.

Lizenz

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