Jeero MCP

Jeero MCP

Jeero MCP は、Jeero のサブスクリプションとイベントデータを扱うローカルの Model Context Protocol サーバーです。Mother と同期し、ローカルのイベントキャッシュを SQLite に保存します。WordPress やホスト型 MCP サービスは必要ありません。

インストール

Node.js 20 以降を使用し、公開されているパッケージを実行するよう MCP クライアントを設定してください。

{
  "mcpServers": {
    "jeero": {
      "command": "npx",
      "args": ["-y", "jeero-mcp"]
    }
  }
}

サーバーは stdio 経由で通信します。アプリケーションのログを stdout に出力しないでください。

初回の使用

create_subscription でサブスクリプションを作成し、次に設定を指定せずに config_subscription を呼び出します。クライアントが MCP URL elicitation への対応を通知している場合、Jeero はプライベートな設定フローを開始します。対応していない場合、ツールはリンクとアクセスコードを返します。リンクを自分で開き、コードを入力してチケット販売ソリューションを選択し、保存すると、そのソリューション固有のコネクター項目が読み込まれます。キーはブラウザーのページでのみ入力してください。ページはプライベートに保ち、エージェントやそのブラウザーツールにページの確認や入力を依頼しないでください。

画面は、MCP サーバーと同じコンピューター上の 127.0.0.1 で動作します。リンクは 15 分後、またはサーバーの停止時に期限切れになります。アプリの URL プロンプトが動作しない場合は、manual: true を指定して config_subscription を呼び出すと、新しいリンクを取得できます。このローカル画面を使用するには MCP サーバーのコンピューター上のブラウザーが必要です。リモートでホストされる設定ポータルではありません。

create_subscription または config_subscription を通じて指定できる設定は、settings.theater のみです。すべての認証情報を含むその他の設定は、ブラウザーで入力する必要があります。保存済みの既存設定は引き続き使用できます。これは、任意の設定入力と生のサブスクリプションエンベロープを意図的に置き換えるものです。現在、get_subscription と create_subscription は、設定済みフィールド名、必須フィールドの入力状況、接続エラー数を含む概要を返します。入力状況が完全でも、キーが有効であることを示すものではありません。同期も確認してください。生の Mother メタデータ、フィールド値、保存済みの認証情報がこれらのツールから返されることはありません。

デフォルトにできるサブスクリプションは 1 つです。subscription を省略すると、ツールはデフォルトのサブスクリプションを使用します。複数のアクティブなサブスクリプションに対応しています。

get_events は、選択したサブスクリプションを最大 1 分に 1 回同期します。サーバーの実行中は、アクティブなサブスクリプションも毎分確認されます。すぐに更新する必要がある場合は、force: true を指定して sync_subscription または sync_subscriptions を使用してください。

ツール

• サブスクリプション管理：list_subscriptions、create_subscription、get_subscription、config_subscription、set_default_subscription、activate_subscription、deactivate_subscription
• 同期：sync_subscription、sync_subscriptions
• イベントデータ：get_events、get_event、list_event_categories、get_ticket_snapshots、get_logs

ローカルデータと設定

デフォルトでは、Jeero MCP は SQLite キャッシュと永続的なサイト ID を ~/.jeero-mcp/ に保存します。このディレクトリは非公開にしてください。この ID は Mother へのリクエストに使用されます。

認証情報はローカルの SQLite 設定に保存され、既存の API を使用して Mother に送信されます。この変更により、MCP ツールの回答やエラーに認証情報が含まれなくなります。ただし、データベースは暗号化されず、以前のチャット履歴や既存のデバッグファイルからキーが消去されることもありません。ツールの出力と新たにインポートしたログでは既知の認証情報がマスクされ、リクエストのトレースにはクエリ文字列とレスポンス本文が含まれません。設定画面では、サードパーティのスクリプトやアセットは読み込まれません。

新規インストールでは、ランダムな UUID をサイト ID として使用し、site-identity.json に保存して、再起動後も再利用します。既存のインストールでは、保存済みの ID とキーをそのまま使用するため、Mother のサブスクリプションと受信トレイに引き続きアクセスできます。この ID ファイルを別の独立したインストールにコピーしないでください。

変数	用途
JEERO_DATA_DIR	ローカルデータディレクトリを上書きします。
JEERO_SITE_URL	新規インストールで使用する任意のサイト ID の上書き設定です。デフォルトはランダムな UUID です。既存の保存済み ID が優先されます。
JEERO_MOTHER_BASE_URL	Mother のベース URL を上書きします。ステージング環境などで使用します。
JEERO_NO_OF_ITEMS_PER_PICKUP	同期ごとにリクエストする受信トレイ項目の数を制限します。
JEERO_LOG_MOTHER	true、1、yes、on のいずれかを指定して、Mother へのリクエストトレースを有効にします。
JEERO_LOG_MOTHER_FILE	トレースログのパスを上書きします。

Mother は引き続き上流の信頼できる情報源です。Jeero MCP は処理済みのイベント記録と同期状態を保存し、生の受信トレイペイロードは保存しません。

開発

npm install
npm test
npm pack --dry-run

タグベースの公開ワークフローでは、バージョンタグから公開する前に、リポジトリで明示的なリリース承認が必要です。

ライセンス

MIT