NS Travel Information MCP Server

NS 旅行情報 MCP サーバー

AI アシスタントをオランダ鉄道のエキスパートに変えましょう！この MCP サーバーは Claude を NS（Nederlandse Spoorwegen）のリアルタイム旅行情報に接続し、オランダを列車で移動する際の頼れるパートナーになります。

インストール

このサーバーは次の3つの方法でインストールできます。

1. NPM パッケージを使って Claude Desktop にインストール

Claude の設定ファイル（~/Library/Application Support/Claude/claude_desktop_config.json）を更新します。

{
  "mcpServers": {
    "ns-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

API キーは NS API Portal から取得できます。

2. Smithery を使う

Smithery 経由で NS Travel Information Server を自動インストールします。

npx -y @smithery/cli install ns-server --client claude

3. ソースからインストール

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

   npm install
   

3. 環境変数ファイルのサンプルをコピーします。

   cp .env.example .env
   

4. .env ファイルに NS API キーを追加します。

   NS_API_KEY=your_api_key_here
   

その後、Claude の設定ファイルを更新します。

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

次の点を確認してください。

1. /path/to/ns-server をインストール先の実際のパスに置き換えます
2. env セクションに NS API キーを追加します。キーは https://apiportal.ns.nl/product#product=NsApp から取得できます。

設定を更新した後、変更を反映するために Claude Desktop を再起動します。

実際の使用例

• 「Almere から Amsterdam へ向かう、いつもの8:15の列車は定刻どおりですか？」
• 「今日は Rotterdam〜Den Haag 間の路線に遅延がありますか？」
• 「直通路線が保守作業中の場合、Utrecht へ行く最適な代替ルートは何ですか？」
• 「午前9時前に Amsterdam Zuid のオフィスに着くには、どの列車に乗ればよいですか？」
• 「ベビーカーで Amsterdam へ行く場合、乗り換えが最も少ないルートはどれですか？」
• 「Den Haag で午前10時の会議に間に合う、最も早い列車は何時発ですか？」
• 「Amsterdam で夜を過ごした後、Groningen へ戻る最終列車は何時ですか？」
• 「月曜朝の授業に影響する可能性のある、週末の工事はありますか？」
• 「午後の会議に向かうため、Utrecht Centraal で OV-fiets の自転車を利用できますか？」
• 「Eindhoven Strijp-S 駅は車椅子で利用できますか？また、ホームはいくつありますか？」
• 「次の1時間で Utrecht Centraal に到着する列車は何ですか？」
• 「Venlo から Schiphol Airport への列車は定刻どおりに到着しましたか？」
• 「Amsterdam から Rotterdam までの1等車の運賃はいくらですか？」
• 「大人2人と子ども1人で Den Haag へ行く場合、運賃はいくらですか？」

🔑 環境変数

変数	説明
NS_API_KEY	NS API キー（必須）

🌟 機能

この MCP サーバーは、次のエンドポイントを通じて NS の列車情報に包括的にアクセスできます。

リアルタイムの列車情報

• 出発：ホーム番号、遅延、運行情報を含むリアルタイムの出発情報を取得します
• 到着：始発駅、ホームの変更、運行状況の更新を含む、今後の列車の到着情報を確認できます
• 経路計画：乗り換えやリアルタイムの更新を考慮した最適な移動経路を検索します
• 運行情報：運行障害、保守作業、工事情報を確認します

料金情報

• チケット料金：片道および往復の正確な料金を取得できます
• 乗車クラス：1等車と2等車の料金を比較できます
• グループ料金：大人と子どもの運賃を計算できます
• 割引オプション：連続乗車割引や特別オファーを確認できます
• 有効期間の詳細：チケットの有効期間と乗車条件を確認できます

駅情報

• 駅の詳細：以下を含む、駅の包括的な情報にアクセスできます
  • 設備とアクセシビリティ機能
  • ホームの配置と線路情報
  • OV-fiets（自転車レンタル）の利用可能状況
  • 場所とアクセス方法の詳細

その他の機能

• 多言語対応：オランダ語と英語で情報を利用できます
• 柔軟な検索：駅名、コード、UIC識別子で検索できます
• タイムゾーン：国際駅のタイムゾーンを適切に処理します
• 運行状況の更新：変更、遅延、運休をリアルタイムで追跡できます

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルをご覧ください。