GrandOrgue MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GrandOrgue MCP
Modern Organ Console — a free control surface for the GrandOrgue pipe organ simulator.
GrandOrgue MCP gives GrandOrgue a beautiful, responsive web console + AI-agent-capable backend. It connects to GrandOrgue via MIDI and replaces its aging wxWidgets GUI with a modern React dashboard. Every stop, piston, manual, and swell pedal is controllable from any browser — or from an AI agent via MCP tools.
Built for the GrandOrgue community with gratitude for decades of free organ simulation. This is our contribution back — a modern console layer that works with any existing GrandOrgue installation and sample set.
Contents
README.md — this file, overview and quick start
docs/GRANDORGUE_GUIDE.md — what GrandOrgue is, history of PC organ simulation, Hauptwerk comparison
docs/ARCHITECTURE.md — system architecture, MIDI bridge, port layout
docs/BACH_CATALOG.md — complete J.S. Bach organ MIDI repertoire
docs/MIDI_SETUP.md — step-by-step MIDI configuration
docs/MCP_TOOLS.md — AI agent tool reference
docs/SAMPLE_SETS.md — marketplace, free sample sets, installation guide
Related MCP server: Chrome MCP Server
Quick Start
Prerequisites
GrandOrgue installed (Windows / Linux / macOS)
uv for Python dependency management
Node.js 20+ for the web console
One-Command Setup
# Install backend deps
just install
# Install frontend deps
just install-web
# Launch everything (backend + frontend + browser)
just webThe backend starts on port 11010 (HTTP mode), the frontend on port 11011.
Claude Desktop (stdio)
The server defaults to stdio transport for MCP clients. Build the bundle with
just mcpb and install dist/grandorgue-mcp-vX.Y.Z.mcpb in Claude Desktop.
The webapp uses HTTP mode (MCP_TRANSPORT=http), which just web sets automatically.
Manual Start
# Terminal 1 — Backend
uv run grandorgue-mcp
# Terminal 2 — Frontend (opens browser)
cd web_sota && bun run devFirst-Time Setup
Install GrandOrgue from GitHub Releases
Install at least one free sample set (see docs/SAMPLE_SETS.md)
Start the MCP server (
uv run grandorgue-mcp)Open the web console at http://127.0.0.1:11011
From the Dashboard, click Start GrandOrgue then Connect MIDI
GrandOrgue must be configured to use the virtual MIDI ports (see docs/MIDI_SETUP.md)
Ports
Port | Service |
11010 | Backend (HTTP mode) — FastMCP 3.4 ( |
11011 | Frontend — Vite React SPA, proxies |
Tech Stack
Layer | Technology |
Backend | Python 3.12+, FastMCP 3.4, FastAPI, uvicorn |
MIDI Bridge | mido + python-rtmidi (virtual ports) |
Audio Engine | GrandOrgue C++ (untouched — MIDI control only) |
Frontend | React 18, TypeScript, Tailwind CSS, Vite (Bun), Zustand, Lucide, react-router-dom, framer-motion, react-markdown |
Linting | Ruff (Python), Biome (TypeScript) |
Testing | pytest + Playwright e2e |
License
MIT — free for the GrandOrgue community, forever.
This server cannot be deployed
Maintenance
Related MCP Connectors
Browser DAW for AI assistants: build multitrack songs with MIDI, effects, stems and generation.
Autonomous music production for AI agents with MIDI generation, QC and provenance.
OSC ↔ MIDI bridge for synthesizers and DAWs, with the SynthHub catalogue. A MIDI MCP and OSC MCP.
Choir management for AI assistants: events, RSVP, announcements and sheet music of your choir.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation, and network monitoring directly within your daily Chrome environment.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn extension-based MCP server that enables AI assistants to control your existing Chrome browser, leveraging your active login states and settings for automation. It provides over 20 tools for tasks like semantic tab search, screen capture, network monitoring, and direct element interaction.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Chrome browser actions like navigation, clicking, form filling, screenshots, and console/network logging via an MCP server and Chrome extension.605 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to access live console logs, errors, and network requests from web applications via a local WebSocket connection, without copying data to chat.13 npm19MIT