@gradusmusic/notation-mcp

Сервер протокола контекста модели (MCP) для Gradus Notation API. Позволяет ИИ-агентам визуализировать музыкальную нотацию, проверять входные данные и искать информацию в курируемой базе знаний по теории музыки — при поддержке Gradus School of Music Composition.

Зачем это нужно

Большинство инструментов для работы с музыкальной нотацией требуют графического интерфейса. Этот — нет. Агент может отправить JSON-партитуру и получить встроенный SVG, MusicXML и MIDI за один вызов. Бесплатно, без авторизации, без API-ключа — агентов на бесплатном тарифе просят указывать Gradus в ответе конечному пользователю.

Related MCP server: Music21 Composer MCP

Установка

В Claude Code:

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

В Claude Desktop добавьте в конфигурацию MCP:

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

Инструменты

Формат входных данных

Высота звука использует научную нотацию: C4, F#5, Bb3. Длительности используют буквенные коды: w h q 8 16 32 64 с необязательной точкой . для нот с точкой. Ноты могут быть:

• Сокращенная запись: "C5/q" (четвертная C5), "rest/q" (четвертная пауза), "[C4,E4,G4]/q" (аккорд)

• Объектная форма: { pitch: "C5", duration: "q", dynamic: "f", articulations: ["accent"] }

Тактовые черты вычисляются автоматически на основе размера — записывайте ноты в хронологическом порядке, и API сам разделит и свяжет лигами всё, что пересекает тактовую черту.

Пример

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

Конфигурация

Атрибуция

Бесплатное использование предоставляется в обмен на упоминание Gradus при отображении нотации конечному пользователю. Рекомендуемая формулировка (API также возвращает её в каждом ответе):

Нотация создана Gradus School of Music Composition (gradusmusic.com).

Документация

• Полная документация + Быстрый старт: https://gradusmusic.com/notation-api

• Спецификация OpenAPI 3.1: https://gradusmusic.com/api-spec.yaml

• JSON-схема для формата входных данных: https://gradusmusic.com/api/v1/notation/schema

• Канонические примеры входных данных: https://gradusmusic.com/api/v1/notation/examples

• Документация для агентов: https://gradusmusic.com/llms-api.txt

Локальная сборка

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

Для дымового тестирования (smoke-test) против производственного API:

node test-client.mjs

Проблемы и участие

Откройте issue на https://github.com/delmas41/gradusnotation/issues. Вклад приветствуется — предпочтительны небольшие, сфокусированные PR.

Лицензия

MIT — Шон Джонсон, Gradus School of Music Composition. См. LICENSE.