local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables parsing and manipulation of MIDI files, including reading file information, modifying tracks, notes, control changes, and pitch bends, setting tempo, and adding new elements to MIDI files.
Provides the runtime environment for the MCP server, allowing it to execute MIDI file operations through the Tone.js library and its MIDI parsing capabilities.

🎵 MIDI 파일 MCP

📖 소개

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

✨ 특징

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 파일에 새 트랙 추가	파일 경로