16bits-audio-mcp은(는) 무엇을 하나요?
Zig MCP 서버와 결정론적 시드 기반 출력을 사용하여 16비트 PCM WAV 파일로 반복 가능한 게임 오디오를 생성합니다.
개요
이 MCP 서버는 AI 에이전트(Claude Code, Cursor, Codex 등)가 zig 명령어를 통해 16비트 PCM WAV 오디오 파일을 생성할 수 있게 해줍니다. 출력은 결정론적이므로 동일한 매개변수와 시드를 사용하면 항상 동일한 오디오가 생성됩니다.
전제 조건
- Zig (최신 버전 권장)
- MCP를 지원하는 AI 에이전트 (Claude Code, Cursor, Codex 등)
설치
git clone https://github.com/Problematic-paratroops563/16bits-audio-mcp.git
cd 16bits-audio-mcp
zig build
MCP 설정
AI 에이전트가 이 서버를 사용하도록 설정하려면 MCP 구성에 다음을 추가하세요:
{
"mcpServers": {
"16bits-audio-mcp": {
"command": "/path/to/zig",
"args": ["run", "/path/to/16bits-audio-mcp/src/main.zig"],
"env": {}
}
}
}
사용법
AI 에이전트에게 오디오 파일 생성을 요청하세요. 예를 들어:
"440Hz 사인파를 2초 동안 생성하고 파형을 저장해줘"
서버는 output/ 디렉토리에 WAV 파일을 생성합니다.
매개변수
서버는 입력 텍스트에서 다음 매개변수를 인식합니다:
- 주파수: Hz 단위 (예: 440)
- 지속 시간: 초 단위 (예: 2.0)
- 파형: sine, square, sawtooth, triangle, noise
- 시드: 재현 가능한 출력을 위한 정수 (옵션)
- 볼륨: 0.0 ~ 1.0 (기본값: 0.5)
출력 형식
- 포맷: 16비트 PCM WAV
- 샘플 레이트: 44100 Hz
- 채널: 모노
- 파일 확장자:
.wav
예제
// 440Hz 사인파를 2초 동안 생성
const audio = try generateSineWave(allocator, 440.0, 2.0, 0.5, 12345);
try writeWav("output/sine_440.wav", audio);
문제 해결
- Zig를 찾을 수 없음: PATH에 Zig가 설치되어 있는지 확인하세요.
- 권한 거부됨: Zig 바이너리에 실행 권한이 있는지 확인하세요.
- 출력 디렉토리 없음:
output/디렉토리를 수동으로 생성하거나 프로그램이 생성하도록 하세요.