MIDI File MCP

🎵 MIDI 파일 MCP

📖 소개

Tone.js와 @tonejs/midi 라이브러리를 기반으로 하는 MIDI 파일 파싱 및 조작 도구로, MCP(Model Context Protocol) 서비스를 통해 기능을 제공합니다. 이 도구를 사용하면 MIDI 파일 형식의 복잡성을 깊이 파고들지 않고도 MIDI 파일을 쉽게 읽고, 분석하고, 수정할 수 있습니다.

✨ 특징

• MIDI 파일 정보 읽기
• 트랙, 노트, 컨트롤 변경 및 피치 벤드 정보를 가져오고 수정합니다.
• MIDI 파일 템포(BPM) 설정
• 특정 트랙에 새로운 노트, 컨트롤 변경 및 피치 벤드를 추가합니다.
• 새로운 트랙 추가
• 포괄적인 오류 처리

📥 필수 조건

1. Node.js 설치: npx 명령이 정상적으로 실행되는지 확인하세요. Node.js 공식 웹사이트 에서 최신 안정 버전을 설치하는 것이 좋습니다.

🔧 사용법

MCP 클라이언트와 함께 사용할 수 있는 지원되는 클라이언트는 다음과 같습니다(이에 국한되지 않음).

• 커서
• 체리 스튜디오
• 클로드 데스크탑

커서 구성 예

Cursor에서 midi-file-mcp를 구성하세요:

지엑스피1

🎹 절대 경로를 사용한 MIDI Parser MCP 사용

MIDI Parser MCP의 모든 작업에는 MIDI 파일의 절대 경로가 필요합니다. 이를 통해 도구가 현재 작업 디렉터리에 관계없이 MIDI 파일을 정확하게 찾고 조작할 수 있습니다.

예시 프롬프트

AI 비서와 함께 사용할 수 있는 몇 가지 프롬프트 예시는 다음과 같습니다.

1. MIDI 파일 정보 가져오기 :
   Can you show me information about the MIDI file at D:\path\to\your\file.mid?
2. 트랙 분석 :
   Please analyze all tracks in D:\path\to\your\file.mid and tell me how many notes are in each track.
3. 템포 설정 :
   Change the tempo of D:\path\to\your\file.mid to 120 BPM.
4. 노트 작업 :
   Show me all notes in track 1 of D:\path\to\your\file.mid.
5. 메모 추가 :
   Add a C4 note at position 0 with a duration of 1 beat to track 0 in D:\path\to\your\file.mid.

사용 가능한 작업

참고 : 오류를 방지하려면 Windows 경로를 사용할 때 항상 파일 경로에 이중 백슬래시( \\ ) 또는 슬래시( / )를 사용하세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

다음 프로젝트와 라이브러리 덕분에 이 도구가 탄생할 수 있었습니다.

• Tone.js - 웹 오디오 프레임워크
• @tonejs/midi - MIDI 파일 파싱 및 조작 라이브러리
• MCP(Model Context Protocol) - AI 어시스턴트에 도구 통합을 가능하게 합니다.