Keyboardia
About
Create, co-edit, analyze, publish, and export collaborative step-sequencer sessions through MCP.
Details
- Author
- adewale
- Categories
- Productivity, Communication
Jump to
Setup
Install Keyboardia in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/adewale/keyboardia
Follow the installation instructions in the repository README, then restart your MCP client.
A multiplayer step sequencer with polyrhythmic patterns, built for real-time collaboration.
- 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
To co-edit music you already have, open a session and give the agent the UUID from itshttps://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 thestateless MCP rhythm-slice specificationfor the exact tool contract and current limitations. Directory maintainers can use the canonicalMCP listing record, and hosted data handling is described in theMCP privacy notice.
- Frontend: React 19, TypeScript, Vite
- Audio: Web Audio API, Tone.js
- Backend: Cloudflare Workers, Durable Objects, KV Storage
- Real-time: WebSockets with Hibernation API
cd app # Install dependencies npm install # Start development server npm run dev # Run tests npm run test:all # Build for production npm run build
Add?debug=1to the URL to enable debug features:
- Event tracing
- Audio state debugging
- Persistent log storage
- Bug pattern detection
Seedocs/DEVELOPMENT-TOOLS.mdfor comprehensive debugging documentation.
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
cd app npm run test:unit # Unit tests (vitest) npm run test:integration # Integration tests (Cloudflare Workers) npm run test:all # All tests npm run analyze:bugs # Static bug pattern analysis
Source (Oscillator/Sample) → Track Gain (per-track volume) → Master Gain → Effects Chain (Tone.js: reverb → delay → chorus → distortion) → Limiter → Compressor → Destination
- SynthEngine(synth.ts) - Native Web Audio oscillators, 40+ presets
- ToneSynthManager(toneSynths.ts) - Tone.js FM/AM/Membrane synths
- AdvancedSynthEngine(advancedSynth.ts) - Dual-oscillator with filter envelope and LFO
- SampledInstrument(sampled-instrument.ts) - Sample-based playback (piano)
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
- ROADMAP.md- Implementation phases and status
- SYNTHESIS-ENGINE.md- Audio architecture spec
- SHARING-AND-PUBLISHING.md- Session persistence spec
- DEVELOPMENT-TOOLS.md- Debug tools reference
- UI-PHILOSOPHY.md- Design principles
- LESSONS-LEARNED.md- Debugging war stories
Bundled instrument samples are third-party content with their own licenses (CC0, public domain, and similar free-use terms), documented inapp/public/instruments/LICENSE.md.
Remote MCP server for MindMeister. Create, edit, and organize mind maps from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.mindmeister.com/mcp
Collaborative word processor you can use with your agent
Keep teams & agents coordinated automatically
Collaborative AI creative workspace for agencies and ecommerce teams to generate on-brand images, videos, and ad creative at scale.
Carryo is a remote MCP server for sharing Claude or ChatGPT-created HTML artifacts as live links.
An MCP server for integrating ClickUp tasks with AI applications, featuring task dependency management and bug fixes.
The Collaboard MCP Server lets AI assistants create, search, analyze, and transform whiteboards into visual, collaborative workspaces.
An MCP server that enables AI assistants to interact with Confluence content through a standardized interface.
Publish Markdown or HTML to a clean, shareable link straight from your AI assistant — OAuth, no API keys.
An MCP server for interacting with the esa.io knowledge-sharing platform.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
