🎵 MIDI 파일 MCP
📖 소개
Tone.js와 @tonejs/midi 라이브러리를 기반으로 하는 MIDI 파일 파싱 및 조작 도구로, MCP(Model Context Protocol) 서비스를 통해 기능을 제공합니다. 이 도구를 사용하면 MIDI 파일 형식의 복잡성을 깊이 파고들지 않고도 MIDI 파일을 쉽게 읽고, 분석하고, 수정할 수 있습니다.
Related MCP server: MCP Claude Code
✨ 특징
MIDI 파일 정보 읽기
트랙, 노트, 컨트롤 변경 및 피치 벤드 정보를 가져오고 수정합니다.
MIDI 파일 템포(BPM) 설정
특정 트랙에 새로운 노트, 컨트롤 변경 및 피치 벤드를 추가합니다.
새로운 트랙 추가
포괄적인 오류 처리
📥 필수 조건
Node.js 설치: npx 명령이 정상적으로 실행되는지 확인하세요. Node.js 공식 웹사이트 에서 최신 안정 버전을 설치하는 것이 좋습니다.
🔧 사용법
MCP 클라이언트와 함께 사용할 수 있는 지원되는 클라이언트는 다음과 같습니다(이에 국한되지 않음).
커서 구성 예
Cursor에서 midi-file-mcp를 구성하세요:
지엑스피1
🎹 절대 경로를 사용한 MIDI Parser MCP 사용
MIDI Parser MCP의 모든 작업에는 MIDI 파일의 절대 경로가 필요합니다. 이를 통해 도구가 현재 작업 디렉터리에 관계없이 MIDI 파일을 정확하게 찾고 조작할 수 있습니다.
예시 프롬프트
AI 비서와 함께 사용할 수 있는 몇 가지 프롬프트 예시는 다음과 같습니다.
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.
사용 가능한 작업
작업 | 설명 | 매개변수 |
get_midi_info | 일반 MIDI 파일 정보 가져오기 | 파일 경로 |
템포 설정 | MIDI 파일의 템포(BPM) 설정 | 파일 경로, bpm |
트랙 정보 가져오기 | 모든 트랙에 대한 정보를 얻으세요 | 파일 경로 |
인덱스별 트랙 정보 가져오기 | 특정 트랙에 대한 정보 얻기 | 파일 경로, 트랙 인덱스 |
인덱스별 노트 가져오기 | 특정 트랙의 모든 노트 가져오기 | 파일 경로, 트랙 인덱스 |
인덱스로 피치벤드 가져오기 | 특정 트랙에서 모든 피치 벤드 가져오기 | 파일 경로, 트랙 인덱스 |
인덱스별 제어 변경 가져오기 | 특정 트랙에서 모든 제어 변경 사항 가져오기 | 파일 경로, 트랙 인덱스 |
인덱스별 노트 추가 | 특정 트랙에 노트 추가 | filePath, trackIndex, notes |
인덱스별_제어_변경_추가 | 특정 트랙에 제어 변경 사항 추가 | filePath, trackIndex, controlchanges |
인덱스별 피치벤드 추가 | 특정 트랙에 피치 벤드 추가 | filePath, trackIndex, 피치벤드 |
트랙 추가 | MIDI 파일에 새 트랙 추가 | 파일 경로 |
참고 : 오류를 방지하려면 Windows 경로를 사용할 때 항상 파일 경로에 이중 백슬래시( \\ ) 또는 슬래시( / )를 사용하세요.
📄 라이센스
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.
🙏 감사의 말
다음 프로젝트와 라이브러리 덕분에 이 도구가 탄생할 수 있었습니다.
Tone.js - 웹 오디오 프레임워크
@tonejs/midi - MIDI 파일 파싱 및 조작 라이브러리
MCP(Model Context Protocol) - AI 어시스턴트에 도구 통합을 가능하게 합니다.