grandorgue-mcp

GrandOrgue MCP

モダンなオルガンコンソール — GrandOrgue パイプオルガンシミュレーター用の無料コントロールサーフェスです。

GrandOrgue MCP は、GrandOrgue に美しく応答性の高いウェブコンソールと、AI エージェント対応のバックエンドを提供します。MIDI 経由で GrandOrgue に接続し、古くなった wxWidgets GUI をモダンな React ダッシュボードに置き換えます。すべてのストップ、ピストン、手鍵盤、スウェルペダルを、任意のブラウザーまたは MCP ツールを介した AI エージェントから操作できます。

長年にわたる無料のオルガンシミュレーションへの感謝を込めて、GrandOrgue コミュニティのために開発しました。既存の GrandOrgue インストール環境やサンプルセットで動作する、モダンなコンソールレイヤーをコミュニティに還元します。

---

目次

• クイックスタート
• ドキュメント
  • README.md — 概要とクイックスタートを記載したこのファイル
  • docs/GRANDORGUE_GUIDE.md — GrandOrgue とは何か、PC オルガンシミュレーションの歴史、Hauptwerk との比較
  • docs/ARCHITECTURE.md — システムアーキテクチャ、MIDI ブリッジ、ポート構成
  • docs/BACH_CATALOG.md — J.S. Bach のオルガン MIDI レパートリー全曲
  • docs/MIDI_SETUP.md — MIDI の設定手順
  • docs/MCP_TOOLS.md — AI エージェント向けツールリファレンス
  • docs/SAMPLE_SETS.md — マーケットプレイス、無料サンプルセット、インストールガイド
• ポート
• 技術スタック
• ライセンス

---

クイックスタート

前提条件

• GrandOrgue がインストール済み（Windows／Linux／macOS）
• Python の依存関係管理用の uv
• ウェブコンソール用の Node.js 20+

1 コマンドでセットアップ

# Install backend deps
just install

# Install frontend deps
just install-web

# Launch everything (backend + frontend + browser)
just web

バックエンドは ポート 11010（HTTP モード）、フロントエンドは ポート 11011 で起動します。

Claude Desktop（stdio）

MCP クライアント向けのトランスポートは、デフォルトで stdio です。just mcpb でバンドルをビルドし、dist/grandorgue-mcp-vX.Y.Z.mcpb を Claude Desktop にインストールします。 ウェブアプリは HTTP モード（MCP_TRANSPORT=http）を使用し、just web が自動的に設定します。

手動での起動

# Terminal 1 — Backend
uv run grandorgue-mcp

# Terminal 2 — Frontend (opens browser)
cd web_sota && bun run dev

初回セットアップ

1. GitHub Releases から GrandOrgue をインストールします
2. 無料サンプルセットを少なくとも 1 つインストールします（docs/SAMPLE_SETS.md を参照）
3. MCP サーバーを起動します（uv run grandorgue-mcp）
4. http://127.0.0.1:11011 でウェブコンソールを開きます
5. ダッシュボードで Start GrandOrgue をクリックし、続いて Connect MIDI をクリックします
6. GrandOrgue が仮想 MIDI ポートを使用するよう設定されている必要があります（docs/MIDI_SETUP.md を参照）

---

ポート

ポート	サービス
11010	バックエンド（HTTP モード）— FastMCP 3.4（/mcp）+ FastAPI REST + WebSocket /ws
11011	フロントエンド — Vite React SPA。/api → 11010 にプロキシ

---

技術スタック

レイヤー	技術
バックエンド	Python 3.12+、FastMCP 3.4、FastAPI、uvicorn
MIDI ブリッジ	mido + python-rtmidi（仮想ポート）
オーディオエンジン	GrandOrgue C++（変更なし — MIDI 制御のみ）
フロントエンド	React 18、TypeScript、Tailwind CSS、Vite（Bun）、Zustand、Lucide、react-router-dom、framer-motion、react-markdown
リント	Ruff（Python）、Biome（TypeScript）
テスト	pytest + Playwright e2e

---

ライセンス

MIT — GrandOrgue コミュニティ向けに、永久に無料です。