propresenter-mcp

propresenter-mcp

ProPresenter API を介して ProPresenter のプレゼンテーションを完全に制御できる、包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、27 の API グループに整理された 231 のエンドポイントを備えた ProPresenter API 仕様全体を実装し、モジュール化されたクライアントクラスを通じて公開します。

公式 MCP レジストリ

• https://registry.modelcontextprotocol.io/?q=alxpark%2Fpropresenter-mcp

前提条件

• Node.js 18 以上
• API が有効になっている ProPresenter 7
• ProPresenter が起動しており、ネットワークからアクセスできること

インストール

1. このリポジトリをクローンするか、ソースコードをダウンロードします

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

設定

サーバーは環境変数を使用して ProPresenter に接続します：

• PROPRESENTER_URL - ProPresenter インスタンスの URL（デフォルト：http://localhost:50000）
• PROPRESENTER_PASSWORD - API パスワード（ProPresenter で設定されている場合）

ProPresenter のセットアップ

1. ProPresenter の環境設定を開きます
2. ネットワークタブに移動します
3. 「ネットワーク」を有効にし、ポート番号を確認します（デフォルト：50000）
4. 必要に応じて、API アクセス用のパスワードを設定します

使い方

Claude Desktop での使用

Claude Desktop の設定ファイルに以下を追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propresenter": {
      "command": "node",
      "args": ["/absolute/path/to/propresenter-mcp/build/index.js"],
      "env": {
        "PROPRESENTER_URL": "http://localhost:50000",
        "PROPRESENTER_PASSWORD": "your-password-if-needed"
      }
    }
  }
}

/absolute/path/to/propresenter-mcp をこのプロジェクトの実際のパスに置き換えてください。

VS Code での使用

このサーバーは、付属の MCP 設定を使用して VS Code から直接デバッグできます。

1. VS Code でこのプロジェクトを開きます
2. .vscode/mcp.json によって、サーバーはデバッグ用に自動設定されます
3. MCP 拡張機能を使用して、サーバーをテストおよびデバッグします

コマンド例

接続すると、Claude に ProPresenter の操作を依頼できます。

ステータスと情報：

• 「実行中の ProPresenter のバージョンは何ですか？」
• 「すべてのスクリーンのステータスを表示して」
• 「観客用スクリーンのステータスは？」
• 「現在のスライド情報を取得して」

プレゼンテーション：

• 「現在アクティブなプレゼンテーションは何ですか？」
• 「UUID [uuid] のプレゼンテーションをトリガーして」
• 「次のスライドに進んで」
• 「スライド番号 5 に移動して」
• 「プレゼンテーションのタイムラインを再生して」
• 「コード譜を表示して」
• 「スライド 3 のサムネイルを取得して」

アナウンス：

• 「現在アクティブなアナウンスは何ですか？」
• 「次のアナウンスキューをトリガーして」
• 「アナウンスのタイムラインのステータスを表示して」
• 「アナウンスキュー 2 に移動して」

オーディオとメディア：

• 「すべてのオーディオプレイリストを一覧表示して」
• 「オーディオプレイリスト [id] の内容を表示して」
• 「アクティブなプレイリストの次の曲を再生して」
• 「フォーカス中のオーディオプレイリストをトリガーして」
• 「すべてのメディアプレイリストを一覧表示して」
• 「プレイリスト [playlist_id] のメディア項目 [id] をトリガーして」

プレイリスト：

• 「すべてのプレゼンテーションプレイリストを一覧表示して」
• 「アクティブなプレイリストを表示して」
• 「次のプレイリストにフォーカスして」
• 「フォーカス中のプレイリストの最初の項目をトリガーして」
• 「『Sunday Service』という新しいプレイリストを作成して」

キャプチャ：

• 「現在のキャプチャのステータスは？」
• 「録画を開始して」
• 「キャプチャを停止して」
• 「RTMP で利用可能なキャプチャエンコーディングを表示して」

クリア：

• 「アナウンスレイヤーをクリアして」
• 「すべてのクリアグループを表示して」
• 「クリアグループ [id] をトリガーして」
• 「新しいクリアグループを作成して」

ライブラリ：

• 「すべてのライブラリを一覧表示して」
• 「ライブラリ [id] のプレゼンテーションを表示して」
• 「ライブラリ [library_id] のプレゼンテーション [id] をトリガーして」

ルック：

• 「設定済みのルックをすべて表示して」
• 「現在ライブになっているルックは何ですか？」
• 「ルック [id] に切り替えて」
• 「新しいルックを作成して」

マクロ：

• 「すべてのマクロを一覧表示して」
• 「マクロ [id] をトリガーして」
• 「すべてのマクロコレクションを表示して」
• 「新しいマクロを作成して」

プロップ：

• 「すべてのプロップを一覧表示して」
• 「プロップ [id] をトリガーして」
• 「プロップ [id] をクリアして」
• 「プロップ [id] の自動クリアを一時停止して」
• 「すべてのプロップコレクションを一覧表示して」

ステージ：

• 「現在のステージメッセージを表示して」
• 「ステージメッセージ [message] を表示して」
• 「ステージメッセージを非表示にして」
• 「すべてのステージレイアウトを一覧表示して」
• 「スクリーン [screen_id] にステージレイアウト [layout_id] を設定して」

メッセージ：

• 「すべてのメッセージを表示して」
• 「メッセージ [id] を表示して」
• 「メッセージ [id] を非表示にして」
• 「新しいメッセージを作成して」

タイマー：

• 「すべてのタイマーを一覧表示して」
• 「タイマー [id] を開始して」
• 「タイマー [id] を停止して」
• 「説教タイマーをリセットして」
• 「カウントダウンタイマーを作成して」
• 「現在のシステム時刻を取得して」

テーマ：

• 「すべてのテーマを一覧表示して」
• 「テーマ [id] の詳細を表示して」
• 「テーマ [theme_id] からテーマスライド [slide_id] を取得して」

トランスポート：

• 「プレゼンテーションレイヤーを再生して」
• 「オーディオレイヤーを一時停止して」
• 「アナウンスレイヤーを 30 秒早送りして」
• 「プレゼンテーションの最後に移動して」
• 「現在の再生時間を取得して」

マスク：

• 「すべてのマスクを一覧表示して」
• 「マスク [id] の詳細を表示して」

トリガー：

• 「次のキューをトリガーして」
• 「前のメディア項目をトリガーして」

開発

ビルド

npm run build

ウォッチモード

npm run watch

API リファレンス

このサーバーは、https://openapi.propresenter.com/ でドキュメント化されている ProPresenter API を完全に実装しています。

API の対応範囲

• エンドポイント合計：231 の REST API エンドポイント
• API グループ：27 の機能グループ
• クライアントモジュール：18 の TypeScript クライアントクラス
• ツール定義：18 の MCP ツールモジュール
• ハンドラーモジュール：18 のリクエストハンドラーモジュール
• HTTP メソッド：GET、POST、PUT、DELETE 操作を完全にサポート
• アーキテクチャ：3 層構成を完全に実装（クライアント → ツール → ハンドラー）

231 のすべてのエンドポイントをグループ別に整理した完全な API ドキュメントについては、api/api.md を参照してください。

トラブルシューティング

接続の問題：

• ProPresenter が実行中で、API が有効になっていることを確認してください
• URL とポートが正しいことを確認してください
• ファイアウォールが接続をブロックしていないことを確認してください
• 認証が有効な場合は、パスワードを確認してください

サーバーが起動しない場合：

• npm run build でプロジェクトをビルドしたことを確認してください
• Node.js 18+ がインストールされていることを確認してください
• npm install ですべての依存関係がインストールされていることを確認してください