get_session
Get Keyboardia session
Read the current tempo and compact track patterns from an existing Keyboardia session.
session_id必填
io.github.adewale由 GitHub 账号 adewale 发布v1.1.0更新于 Oct 24, 2026
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
Keyboardia 的远程 MCP 服务器,这是一个协作式步进音序器,让助手创建、编辑、分析、发布和导出音乐会话。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.adewale%2Fkeyboardia/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"keyboardia": {
"type": "http",
"url": "https://keyboardia.dev/mcp"
}
}
}A multiplayer step sequencer with polyrhythmic patterns, built for real-time collaboration.
Configure your MCP client with:
To co-edit music you already have, open a session and give the agent the UUID
from its https://keyboardia.dev/s/{session_id} URL. Agents can read the
current rhythm, add a track, assign specific steps, and change tempo. Their
edits use the same live session as connected browsers, and published sessions
stay read-only.
Agents can also start from nothing: create a new session and hand back its link, remix a published session into an editable copy without touching the original, publish the current result as an immutable snapshot when you ask, and export the session as a MIDI file for a DAW.
They can explain music too — ask what key a session is in, how its rhythms sit against each other, or what chord a moment forms, and the answer comes from the same music-theory module the Key Assistant uses, with its uncertainty stated rather than hidden.
See the stateless MCP rhythm-slice specification for the exact tool contract and current limitations. Directory maintainers can use the canonical MCP listing record, and hosted data handling is described in the MCP privacy notice.
Add ?debug=1 to the URL to enable debug features:
See docs/DEVELOPMENT-TOOLS.md for comprehensive debugging documentation.
synth.ts) - Native Web Audio oscillators, 40+ presetstoneSynths.ts) - Tone.js FM/AM/Membrane synthsadvancedSynth.ts) - Dual-oscillator with filter envelope and LFOsampled-instrument.ts) - Sample-based playback (piano)Bundled instrument samples are third-party content with their own licenses (CC0, public domain, and similar free-use terms), documented in app/public/instruments/LICENSE.md.
来源:README.md,提交 869d3f5
Get Keyboardia session
Read the current tempo and compact track patterns from an existing Keyboardia session.
session_id必填Edit Keyboardia session
Make one narrow, retry-safe edit to an existing collaborative session. After every attempt, the next Keyboardia call must be get_session for the same session. A successful call includes a backwards-compatible compact snapshot plus an acknowledgement. That snapshot is not authoritative verification; do not make another edit or finish from it. Read with get_session next. Supported operations: add_track, set_track_instrument, set_track_pan, set_steps, and set_tempo. set_steps changes only the named steps; it never replaces a track or session. set_track_instrument replaces only a track's sound source, keeping its pattern, mix, timing, and custom name.
edit必填session_id必填Create Keyboardia session
Create a new editable Keyboardia session with the normal defaults and return its shareable URL. The session starts with no tracks; use edit_session to add them. Pass the same idempotency_key when retrying so an uncertain attempt cannot leave duplicate sessions behind.
nametempoidempotency_key必填Remix Keyboardia session
Copy an existing session — published or editable — into a new editable session that records the original as its source. The source is never modified, so this is how to continue from published work.
session_id必填Publish Keyboardia session
Freeze the current music into a new immutable session and return its URL. The source session stays editable at its own URL. Only call this when someone explicitly asks to publish; it is never a side effect of editing or exporting.
session_id必填Export Keyboardia session as MIDI
Export the session as a base64-encoded Standard MIDI File, matching what Keyboardia's own Export MIDI produces for the same music. The session is not modified. The result lists any session features a MIDI file cannot carry rather than approximating them silently.
session_id必填Analyze Keyboardia session
Describe what is happening musically in a session — rhythm, pitch content, inferred key, and chords — without changing anything. Use this to explain music rather than to edit it. Results come from the same music-theory module the browser's Key Assistant and Chromatic Grid use, and report where the analysis is uncertain instead of guessing.
session_id必填已满足适用检查项的 75%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
https://keyboardia.dev/mcpcd app
# Install dependenciesnpm install
# Start development servernpm run dev
# Run testsnpm run test:all
# Build for productionnpm run buildapp/├── src/│ ├── audio/ # Audio engine, synths, effects, scheduling│ ├── components/ # React UI components│ ├── hooks/ # React hooks (useSession, useMultiplayer, etc.)│ ├── state/ # State management (grid reducer)│ ├── sync/ # Multiplayer synchronization│ ├── worker/ # Cloudflare Worker (Durable Objects, API routes)│ ├── utils/ # Logging, debugging, utilities│ └── debug/ # Debug overlay and context├── e2e/ # End-to-end tests (Playwright)├── test/ # Integration tests└── scripts/ # Development and debugging scriptscd appnpm run test:unit # Unit tests (vitest, fast product lane)npm run test:audio-render # Offline audio renders (native Web Audio)npm run test:verification-tooling # Tests of the verification tooling itselfnpm run test:integration # Integration tests (Cloudflare Workers)npm run test:all # All of the abovenpm run analyze:bugs # Static bug pattern analysisSource (Oscillator/Sample) → Track Gain (per-track volume) → Master Gain → Effects Chain (Tone.js: reverb → delay → chorus → distortion) → Limiter → Compressor → DestinationClient A ←→ Durable Object ←→ Client B ↓ DO Storage (immediate) ↓ KV Storage (on disconnect)