Synchro Bus MCP Server

Synchro Bus MCP サーバー

Synchro Bus（Instant-System）API にアクセスするための Model Context Protocol サーバーです。このサーバーでは、Instant-System API v3 のさまざまなエンドポイント、特に Synchro Bus ネットワーク（ID：3）にアクセスできます。

機能

サーバーは以下の API エンドポイントを公開します。

• networkGet：ネットワーク情報を取得
• linesGet：ネットワーク内のすべての路線を取得
• lineGet：特定の路線に関する情報を取得
• lineStopAreasGet：路線の停留所エリアを取得
• lineStopAreaSchedulesGet：路線上の停留所エリアの時刻表を取得
• disruptionsGet：ネットワークの運行障害を取得
• vehicleJourneysDirectionsGet：路線の車両運行の方向を取得

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします。

   npm install
   

3. 環境設定のサンプルファイルをコピーし、設定に合わせて更新します。

   cp .env.example .env
   

4. プロジェクトをビルドします。

   npm run build
   

設定

ルートディレクトリに次の変数を含む .env ファイルを作成します。

INSTANT_SYSTEM_BASE_URL=https://prod.instant-system.com/InstantCore

使用方法

サーバーを起動します。

npm start

自動再読み込みを有効にして開発する場合：

npm run dev

API リファレンス

networkGet

Synchro Bus ネットワークの情報を取得します。

linesGet

ネットワークで利用できるすべての路線を取得します。

lineGet

特定の路線に関する詳細情報を取得します。

lineStopAreasGet

特定の路線のすべての停留所エリアを取得します。

lineStopAreaSchedulesGet

路線上の特定の停留所エリアの時刻表を取得します。

disruptionsGet

ネットワークで現在発生している運行障害を取得します。

vehicleJourneysDirectionsGet

路線の車両運行で利用できる方向を取得します。

開発

• npm run build - プロジェクトをビルドします
• npm run dev - 自動再読み込みを有効にして開発モードでサーバーを起動します
• npm run lint - ESLint を実行します
• npm run format - Prettier でコードを整形します

ライセンス

MIT