English Français العربية

io.github.sandraschi/grandorgue-mcp

Official registry Other

GrandOrgue pipe organ simulator MCP server - MIDI bridge, organ control, sample set management, m...

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

MCPB package https://github.com/sandraschi/grandorgue-mcp/releases/download/v0.3.0/grandorgue-mcp-v0.3.0.mcpb

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. GrandOrgue MCP
  2. Contents
  3. Quick Start
  4. Ports
  5. Tech Stack
  6. License

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

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 web

The 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 dev
First-Time Setup
  1. Install GrandOrgue from GitHub Releases
  2. Install at least one free sample set (see docs/SAMPLE_SETS.md)
  3. Start the MCP server (uv run grandorgue-mcp)
  4. Open the web console at http://127.0.0.1:11011
  5. From the Dashboard, click Start GrandOrgue then Connect MIDI
  6. GrandOrgue must be configured to use the virtual MIDI ports (see docs/MIDI_SETUP.md)

Ports

PortService
11010Backend (HTTP mode) — FastMCP 3.4 (/mcp) + FastAPI REST + WebSocket /ws
11011Frontend — Vite React SPA, proxies /api → 11010

Tech Stack

LayerTechnology
BackendPython 3.12+, FastMCP 3.4, FastAPI, uvicorn
MIDI Bridgemido + python-rtmidi (virtual ports)
Audio EngineGrandOrgue C++ (untouched — MIDI control only)
FrontendReact 18, TypeScript, Tailwind CSS, Vite (Bun), Zustand, Lucide, react-router-dom, framer-motion, react-markdown
LintingRuff (Python), Biome (TypeScript)
Testingpytest + Playwright e2e

License

MIT — free for the GrandOrgue community, forever.

Frequently asked questions

What is io.github.sandraschi/grandorgue-mcp?

GrandOrgue pipe organ simulator MCP server - MIDI bridge, organ control, sample set management, m...

How do I install io.github.sandraschi/grandorgue-mcp?

Follow the installation steps in its documentation, shown on this page and in its repository.

Does io.github.sandraschi/grandorgue-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.sandraschi/grandorgue-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.sandraschi/grandorgue-mcp?

It is published by sandraschi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.