{
  "markdown": "# MCP Music Studio\n\n[![smithery badge](https://smithery.ai/badge/linxule/mcp-music-studio)](https://smithery.ai/server/linxule/mcp-music-studio)\n\nTwo-mode creative music studio for AI: **scored composition** (ABC notation with sheet music) and **live performance** (Strudel live coding with TidalCycles). Interactive UI renders inline in Claude Desktop, claude.ai, and other MCP clients.\n\n## Quick Start — No Install Required\n\nPaste this URL into any MCP client that supports remote servers:\n\n```\nhttps://mcp-music-studio.linxule.workers.dev/mcp\n```\n\n**Claude Desktop / claude.ai:**\nSettings → Connectors → Add Connector → paste the URL above → done.\n\n**Claude Code:**\n```bash\nclaude mcp add --transport http music-studio https://mcp-music-studio.linxule.workers.dev/mcp\n```\n\nThat's it — ask Claude to play a song or create a beat.\n\n---\n\n## What You Get\n\n### Scored Composition (ABC Notation)\nWrite sheet music → see it rendered → hear it played with multi-instrument audio.\n\n- **8 style presets** — rock, jazz, bossa, waltz, march, reggae, folk, classical — one parameter adds drums + bass + chord accompaniment\n- **30 instruments** — piano, strings, brass, woodwinds, synths — selectable by name\n- **Visual sheet music** — notes highlight as they play\n- **Streaming render** — sheet music appears as the AI types\n- **WAV download** — export audio as WAV files directly from the UI\n- **`get-music-guide`** — 7 reference topics (instruments, drums, ABC syntax, arrangements, genres, styles, MIDI directives)\n\n### Live Performance (Strudel)\nWrite code → hear it play → edit in a live REPL.\n\n- **TidalCycles mini-notation** in JavaScript\n- **72 drum machine banks** + **128 GM instruments** + built-in synths\n- **Full effects chain** — filters, reverb, delay, FM synthesis\n- **Editable REPL** — users can tweak the code and hear changes instantly\n- **Live visuals** — add `.pianoroll()` / `.scope()` / `.spectrum()` to animate behind the code (native strudel.cc overlay)\n- **Record & download** — capture live audio and export as WAV\n- **`get-strudel-guide`** — 7 reference topics (mini-notation, sounds, effects, patterns, genres, tips, advanced)\n\n### Shared\n- **`search-music-docs`** — semantic search over strudel.cc and ABCJS documentation\n\n---\n\n## Local Install (Optional)\n\nThe remote URL above works without any local setup. If you prefer running locally (offline use, lower latency), install via npm:\n\n### CLI One-Liners\n\n```bash\n# Claude Code\nclaude mcp add music-studio -- npx -y mcp-music-studio --stdio\n\n# Codex CLI\ncodex mcp add -- npx -y mcp-music-studio --stdio\n\n# Gemini CLI\ngemini mcp add -- npx -y mcp-music-studio --stdio\n\n# OpenCode\nopencode mcp add music-studio -- npx -y mcp-music-studio --stdio\n```\n\n### JSON Config (Claude Desktop, Cursor, Windsurf, etc.)\n\n<details>\n<summary>Claude Desktop — edit config file</summary>\n\n| OS | Path |\n|----|------|\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"music-studio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-music-studio\", \"--stdio\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>VS Code / Trae / PearAI</summary>\n\nAdd to `.vscode/mcp.json` — note: uses `\"servers\"` not `\"mcpServers\"`:\n\n```json\n{\n  \"servers\": {\n    \"music-studio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-music-studio\", \"--stdio\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Cursor</summary>\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"music-studio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-music-studio\", \"--stdio\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Windsurf</summary>\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"music-studio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-music-studio\", \"--stdio\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Windows</summary>\n\nOn Windows, `npx` is a `.cmd` file and requires a shell wrapper:\n\n```json\n{\n  \"mcpServers\": {\n    \"music-studio\": {\n      \"command\": \"cmd\",\n      \"args\": [\"/c\", \"npx\", \"-y\", \"mcp-music-studio\", \"--stdio\"]\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Render modes (for non-ext-apps clients)</summary>\n\nClients that support ext-apps render the interactive UI inline automatically (`auto` mode). For clients that don't (Cherry Studio, CLI environments), use `--render-mode`:\n\n| Mode | Behavior |\n|------|----------|\n| `auto` (default) | Inline UI for Claude Desktop, VS Code |\n| `browser` | Saves HTML and opens in system browser |\n| `html` | Returns HTML as embedded resource |\n\n```json\n{\n  \"mcpServers\": {\n    \"music-studio\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-music-studio\", \"--stdio\", \"--render-mode\", \"browser\"]\n    }\n  }\n}\n```\n</details>\n\n---\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `play-sheet-music` | ABC notation → visual sheet music + multi-instrument audio |\n| `play-live-pattern` | Strudel code → live-coded patterns with synthesis + effects |\n| `get-music-guide` | ABC reference (7 topics: instruments, drums, syntax, genres...) |\n| `get-strudel-guide` | Strudel reference (7 topics: sounds, effects, patterns, genres...) |\n| `search-music-docs` | Semantic search over strudel.cc and ABCJS docs |\n\n## Prompts\n\nSlash-command / menu entry points, in clients that surface MCP prompts:\n\n| Prompt | What it does |\n|--------|--------------|\n| `compose-beat` | Generate + play a Strudel pattern in a genre (args: `genre`, `mood?`) |\n| `harmonize-melody` | Add chords/accompaniment to an ABC melody and play it (args: `melody`, `style?`) |\n| `arrange-tune` | Turn a melody/idea into a multi-voice arrangement (args: `tune`, `instrumentation?`) |\n\n## Development\n\n```bash\nbun install\nbun run dev      # watch + serve (hot reload)\nbun run build    # production build\nbun run test     # run tests\n```\n\n## Attribution\n\nForked from the [Sheet Music Server](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/sheet-music-server) example from [MCP ext-apps](https://github.com/modelcontextprotocol/ext-apps) by Anthropic, licensed under MIT.\n\n## License\n\nMIT\n",
  "bytes": 6207,
  "sha": "ad3a86a9d5b74a82aa551d697542c65a34c1a6822f674c268ff6c67b17c4bb4c",
  "repo_slug": "linxule/mcp-music-studio",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_linxule_mcp_music_studio_362c4571/readme"
}