MIDI-файл MCP

🎵 MIDI-файл MCP

📖 Введение

Это инструмент для анализа и обработки MIDI-файлов на основе Tone.js и библиотеки @tonejs/midi, предоставляющий функциональность через службы MCP (Model Context Protocol). Этот инструмент позволяет вам легко читать, анализировать и изменять MIDI-файлы, не вникая в сложности формата MIDI-файлов.

✨ Особенности

Чтение информации о MIDI-файле
Получать и изменять информацию о треках, нотах, изменениях управления и изменении высоты тона
Установить темп MIDI-файла (BPM)
Добавляйте новые ноты, управляйте изменениями и изменениями высоты тона к определенным трекам.
Добавить новые треки
Комплексная обработка ошибок

📥 Предварительные условия

Установить Node.js : Убедитесь, что команда npx может работать нормально. Рекомендуется установить последнюю стабильную версию с официального сайта Node.js

🔧 Использование

Используйте с клиентом MCP. Поддерживаемые клиенты включают, но не ограничиваются:

Курсор
Студия Черри
Клод Десктоп

Установка через Smithery

Чтобы автоматически установить MIDI File Parser для Claude Desktop через Smithery :

npx -y @smithery/cli install @xiaolaa2/midi-file-mcp --client claude

Пример конфигурации курсора

Настройте midi-file-mcp в курсоре:

"midi-file-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "midi-file-mcp"
    ]
}

🎹 Использование MIDI Parser MCP с абсолютными путями

Все операции в MIDI Parser MCP требуют абсолютного пути к файлу MIDI. Это гарантирует, что инструмент сможет правильно находить и манипулировать вашими файлами MIDI независимо от текущего рабочего каталога.

Примеры подсказок

Вот несколько примеров подсказок, которые вы можете использовать с вашим помощником на базе искусственного интеллекта:

Получить информацию о MIDI-файле :
Can you show me information about the MIDI file at D:\path\to\your\file.mid?
Анализ треков :
Please analyze all tracks in D:\path\to\your\file.mid and tell me how many notes are in each track.
Установка темпа :
Change the tempo of D:\path\to\your\file.mid to 120 BPM.
Работа с заметками :
Show me all notes in track 1 of D:\path\to\your\file.mid.
Добавление примечаний :
Add a C4 note at position 0 with a duration of 1 beat to track 0 in D:\path\to\your\file.mid.

Доступные операции

Операция	Описание	Параметры
получить_midi_info	Получить общую информацию о MIDI-файле	filePath
set_tempo	Установите темп (BPM) MIDI-файла	filePath, ударов в минуту
получить_информацию_о_треках	Получить информацию обо всех треках	filePath
получить_информацию_отслеживания_по_индексу	Получить информацию о конкретном треке	filePath, trackIndex
получить_заметки_по_индексу	Получить все заметки из определенного трека	filePath, trackIndex
получить_отклонения_по_индексу	Получить все изменения высоты тона из определенного трека	filePath, trackIndex
получить_контрольные_изменения_по_индексу	Получить все изменения управления из определенного трека	filePath, trackIndex
добавить_заметки_по_индексу	Добавить заметки к определенному треку	filePath, trackIndex, заметки
добавить_контрольизменения_по_индексу	Добавить изменения управления к определенному треку	filePath, trackIndex, controlchanges
add_pitchbends_by_index	Добавить изменения высоты тона к определенному треку	filePath, trackIndex, изменения высоты тона
добавить_трек	Добавить новый трек в MIDI-файл	filePath

Примечание : всегда используйте двойные обратные косые черты ( \\ ) или прямые косые черты ( / ) в путях к файлам при работе с путями Windows, чтобы избежать ошибок.

📄 Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE.

🙏 Благодарности

Выражаем благодарность следующим проектам и библиотекам, без которых этот инструмент был бы невозможен:

Tone.js — веб-аудио фреймворк
@tonejs/midi — библиотека для анализа и обработки MIDI-файлов
MCP (Model Context Protocol) — делает возможной интеграцию инструментов в помощников на основе искусственного интеллекта.

MIDI File MCP

Integrations