Keyboardia

io.github.adewale由 GitHub 账号 adewale 发布v1.1.0更新于 Oct 24, 2026

Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.

已验证Streamable HTTP可网页运行效率与工作流媒体与设计

概览

AI 生成的概览

Keyboardia 的远程 MCP 服务器,这是一个协作式步进音序器,让助手创建、编辑、分析、发布和导出音乐会话。

可以做什么
读取会话的速度与各轨道模式,并在不做任何修改的情况下分析其节奏、音高内容、推断调性与和弦。创建新会话,把已发布或可编辑的会话混音为可编辑副本,并把当前结果发布为不可变的冻结快照。对现有会话做范围窄、可安全重试的编辑,例如添加轨道、指定步进或更改速度。将会话导出为 base64 编码的标准 MIDI 文件,供 DAW 使用。
适用场景
当你希望助手与已连接的浏览器一起协作编辑 Keyboardia 中的音乐、从零开始新建音序器会话、混音已有作品,或解释某个会话的和声与节奏时使用。
运行要求
通过 streamable HTTP 连接 keyboardia.dev 的远程端点;未声明任何软件包、环境变量或请求头。要编辑已有音乐,需要其分享链接中的会话 UUID。
安装前请注意
编辑会改动其他已连接演奏者可见的实时共享会话,误操作会影响协作者。发布会创建新的不可变会话,应仅在明确要求时进行。导出的 MIDI 可能丢失 MIDI 无法承载的会话特性。托管数据处理受该服务隐私声明约束。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Keyboardia,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.adewale%2Fkeyboardia/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "keyboardia": {
      "type": "http",
      "url": "https://keyboardia.dev/mcp"
    }
  }
}

README

Keyboardia

A multiplayer step sequencer with polyrhythmic patterns, built for real-time collaboration.

Features

  • Real-time Multiplayer - Up to 10 players can jam together on the same session
  • Polyrhythmic Patterns - Each track can have 3-128 step counts (26 options including triplet-friendly values)
  • 70 Sound Generators - 32 Web Audio synths, 11 Tone.js FM/AM synths, 27 sampled instruments
  • 27 Sampled Instruments - Grand piano, 808 kit, acoustic drums, Hammond organ, kalimba, steel drums, strings, guitars, sax, and more
  • Effects Chain - Reverb, delay, chorus, and distortion with limiter (full multiplayer sync)
  • Parameter Locks - Per-step pitch, volume, and tied notes automation
  • Chromatic Grid - Two view modes: "Events" (key intervals + used pitches) and "All" (49 pitches from -24 to +24)
  • Scale Lock - Constrain chromatic grid to selected musical scale with out-of-scale warnings
  • Scale Sidebar - Visualize scale notes with root/fifth emphasis and active usage highlighting
  • Per-track Swing - Global and per-track swing settings for groove control
  • Session Sharing - Share links, remix others' work, publish immutable sessions
  • QR Code Sharing - Mobile-friendly session sharing
  • Agent Rhythm Editing (Experimental) - Co-edit, create, remix, publish, export, and analyze sessions through stateless MCP

Use with an agent

Configure your MCP client with:

text
https://keyboardia.dev/mcp

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.

Tech Stack

  • Frontend: React 19, TypeScript, Vite
  • Audio: Web Audio API, Tone.js
  • Backend: Cloudflare Workers, Durable Objects, KV Storage
  • Real-time: WebSockets with Hibernation API

Getting Started

bash
cd app
# Install dependenciesnpm install
# Start development servernpm run dev
# Run testsnpm run test:all
# Build for productionnpm run build

Development

Debug Mode

Add ?debug=1 to the URL to enable debug features:

  • Event tracing
  • Audio state debugging
  • Persistent log storage
  • Bug pattern detection

See docs/DEVELOPMENT-TOOLS.md for comprehensive debugging documentation.

Project Structure

app/├── 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 scripts

Key Files

FileDescription
app/src/audio/engine.tsMain audio engine - coordinates all audio subsystems
app/src/audio/scheduler.tsDrift-free lookahead scheduling (25ms timer, 100ms lookahead)
app/src/audio/synth.ts16-voice polyphonic synthesizer with voice stealing
app/src/audio/toneSynths.tsTone.js synth manager (FM, AM, Membrane, etc.)
app/src/audio/toneEffects.tsEffects chain (reverb, delay, chorus, distortion)
app/src/sync/multiplayer.tsWebSocket client for real-time sync
app/src/worker/live-session.tsDurable Object for session state

Testing

bash
cd 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 analysis

Architecture

Audio Signal Chain

Source (Oscillator/Sample)    → Track Gain (per-track volume)    → Master Gain    → Effects Chain (Tone.js: reverb → delay → chorus → distortion)    → Limiter    → Compressor    → Destination

Synth Engines

  1. SynthEngine (synth.ts) - Native Web Audio oscillators, 40+ presets
  2. ToneSynthManager (toneSynths.ts) - Tone.js FM/AM/Membrane synths
  3. AdvancedSynthEngine (advancedSynth.ts) - Dual-oscillator with filter envelope and LFO
  4. SampledInstrument (sampled-instrument.ts) - Sample-based playback (piano)

Multiplayer Architecture

Client A ←→ Durable Object ←→ Client B              ↓        DO Storage (immediate)              ↓        KV Storage (on disconnect)
  • Each session is a single Durable Object instance
  • WebSocket connections use Hibernation API for cost efficiency
  • State changes broadcast to all connected clients
  • Hybrid persistence: Mutations saved immediately to DO storage, KV updated on disconnect

Documentation

License

MIT

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

工具

7

get_session

Get Keyboardia session

Read the current tempo and compact track patterns from an existing Keyboardia session.

输入参数session_id必填

edit_session

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_session

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_session

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_session

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_midi

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_session

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必填

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分