Skip to main content
Glama
sandraschi

GrandOrgue MCP

by sandraschi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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

Related MCP server: Chrome MCP Server

Quick Start

Prerequisites

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

Port

Service

11010

Backend (HTTP mode) — FastMCP 3.4 (/mcp) + FastAPI REST + WebSocket /ws

11011

Frontend — Vite React SPA, proxies /api → 11010

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

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Chrome MCP Server

    MNIsRed
    A
    license
    Not graded
    quality
    D
    maintenance
    An 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

  • Chrome MCP Server

    davincinewton
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    An 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.
    -

  • MCP Chrome Bridge

    wizardofweb125-lab
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to control Chrome browser actions like navigation, clicking, form filling, screenshots, and console/network logging via an MCP server and Chrome extension.
    545 npm
    MIT