About Strudel Console
Strudel Console is an MCP server in the Blockchain category: terminal-native music composition tool + MCP server powered by Strudel live-coding engine. It has been installed 0 times through Conduid.
Install
Clone
git clone https://github.com/dastjead/strudel-consoleThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Strudel Console
Powered by Claude · Grounded in docs
I know everything about Strudel Console. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
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) 기반 파생 저작물입니다.
README mirrored from the source repository 4 months ago. The original is authoritative.