Strudel Console

English | 한국어

Strudel 기반 TUI 음악 작곡 도구 + MCP 서버. 터미널에서 라이브 코딩하거나, Claude Code 같은 AI 에이전트를 통해 음악을 만들 수 있습니다.

설치 및 실행

npm install
npm run build

TUI 모드 (기본)

npm start
# 또는
npm run tui

MCP 서버 모드

npm run mcp

Claude Code의 settings.json에 등록:

{
  "mcpServers": {
    "strudel-console": {
      "command": "node",
      "args": ["--experimental-specifier-resolution=node", "/path/to/strudel-console/dist/mcp/server.js"]
    }
  }
}

---

MCP 서버 스펙

Transport: stdio | Protocol: MCP | Version: 0.1.0

도구 (Tools)

Playback

도구	설명	파라미터
evaluate	Strudel 패턴 코드를 평가하고 즉시 재생 시작	code (string, 필수)
start	현재 패턴 재생 시작/재개	—
stop	재생 중지	—
toggle	재생/중지 토글	—
set_bpm	BPM 설정 (기본 120)	bpm (number, 양수)
get_state	현재 상태 조회 (재생 여부, 코드, 에러 등)	—

Samples

도구	설명	파라미터
load_samples	샘플/뱅크 로드	source (string) — github:user/repo, 로컬 경로, 또는 URL

Patterns

도구	설명	파라미터
save_pattern	패턴을 ~/.strudel-console/patterns/에 저장	name (string), code (string), bpm (number, 선택)
load_pattern	저장된 패턴 불러오기	name (string)
list_patterns	저장된 패턴 목록 조회	—

Multi-Track

도구	설명	파라미터
add_track	새 트랙 추가. 모든 활성 트랙은 stack()으로 동시 재생	name (string, 선택), code (string, 선택)
evaluate_track	트랙의 패턴 코드를 업데이트하고 재컴파일	code (string), track_index (int, 1-based, 선택 — 생략 시 활성 트랙)
remove_track	트랙 삭제	track_index (int, 1-based)
mute_track	트랙 뮤트 토글	track_index (int, 1-based)
solo_track	트랙 솔로 토글. 솔로 트랙이 있으면 솔로만 재생	track_index (int, 1-based)
set_track_gain	트랙 볼륨 설정	track_index (int, 1-based), gain (number, 0.0–1.0)
list_tracks	전체 트랙 목록 + 상태 (이름, 뮤트, 솔로, 게인, 코드)	—

Mixer

도구	설명	파라미터
set_master_gain	마스터 출력 볼륨 설정 (전 트랙 적용)	gain (number, 0.0–1.0)
list_effect_presets	이펙트 프리셋 목록 조회	—

사용 가능한 이펙트 프리셋:

프리셋	이펙트 체인
clean	(없음)
lofi	.lpf(800).gain(0.8)
ambient	.room(0.6).delay(0.4).gain(0.7)
dark	.lpf(400).room(0.3).gain(0.9)
bright	.hpf(300).lpf(8000).gain(0.9)
tape	.lpf(3000).room(0.2).delay(0.15).gain(0.85)

Render

도구	설명	파라미터
render_to_file	패턴을 WAV 파일로 렌더링 (OfflineAudioContext)	code (string, 선택), cycles (int, 1–64, 기본 8), bpm (number, 선택), filename (string, 선택)

출력 경로: ~/.strudel-console/renders/

AI Composition

도구	설명	파라미터
analyze_pattern	패턴의 음악적 속성 분석 (키, 스케일, 음역, 밀도)	code (string), cycles (int, 1–16, 기본 4)
load_genre_preset	장르 프리셋 로드 — 트랙 + BPM 자동 설정 후 재생 시작	genre (string)
list_genre_presets	장르 프리셋 목록 + 설명 조회	—

사용 가능한 장르 프리셋:

장르	BPM	트랙 수	설명
lofi	75	4	Chill lo-fi beats with jazzy chords
techno	130	4	Driving four-on-the-floor with acid bassline
ambient	60	3	Slow evolving pads with reverb
house	124	5	Classic house groove with organ stabs
dnb	174	3	Fast breakbeat with rolling bass
jazz	110	3	Swing feel with ii-V-I progression

리소스 (Resources)

URI	설명
strudel-console://guide	Strudel 패턴 작성 가이드 (미니 노테이션, 이펙트, 멀티트랙 워크플로우)
strudel-console://music-theory	음악 이론 레퍼런스 (스케일, 코드 진행, 리듬 패턴, 인터벌)

---

워크플로우 예시

1. 단일 패턴 재생

evaluate({ code: 'note("c4 e4 g4 b4").sound("sine")' })
set_bpm({ bpm: 90 })
stop()

2. 멀티트랙 작곡

add_track({ name: "drums", code: 's("bd sd hh sd")' })
add_track({ name: "bass", code: 'note("c2 e2 g2 e2").sound("sawtooth").lpf(400)' })
evaluate_track({ code: 's("bd sd [~ bd] sd")', track_index: 1 })
mute_track({ track_index: 2 })          // 베이스 뮤트
set_track_gain({ track_index: 1, gain: 0.8 })

3. 장르 프리셋 → 커스텀

load_genre_preset({ genre: "lofi" })     // 4트랙 + 75 BPM 세팅
list_tracks()                            // 현재 트랙 확인
evaluate_track({ code: 's("bd ~ [bd sd] ~")', track_index: 1 })  // 드럼 수정
set_master_gain({ gain: 0.7 })

4. 분석 → 렌더링

analyze_pattern({ code: 'note("c4 e4 g4 b4").sound("sine")', cycles: 4 })
render_to_file({ code: 'note("c4 e4 g4 b4").sound("sine")', cycles: 16, bpm: 90, filename: "melody" })

---

에러 처리

모든 도구는 실패 시 isError: true와 함께 에러 메시지를 반환합니다.

상황	에러 예시
잘못된 Strudel 구문	Error: unexpected token ...
존재하지 않는 트랙 인덱스	Error: track 5 does not exist
존재하지 않는 장르	Unknown genre. Available: lofi, techno, ambient, house, dnb, jazz
렌더링할 패턴 없음	Error: no pattern to render. Provide code or set up tracks.
존재하지 않는 패턴 이름	Error: pattern not found: ...

---

기술 스택

• 엔진: @strudel/* v1.1.0 + node-web-audio-api (IRCAM Rust 바인딩)
• MCP: @modelcontextprotocol/sdk (stdio transport)
• TUI: Ink 5.x + React 18
• 언어: TypeScript (ESM)

---

라이선스

이 프로젝트는 GNU Affero General Public License v3.0 or later 하에 배포됩니다.

Strudel (AGPL-3.0-or-later) 기반 파생 저작물입니다.