Ns MCP Server

🚀 NS 旅行情報 MCP サーバー

この MCP サーバーは、Claude とリアルタイムの NS（Nederlandse Spoorwegen）旅行情報を接続し、あなたのAIアシスタントをオランダ鉄道の専門家に変えます。オランダでの鉄道旅行に最適なパートナーになります。

🚀 クイックスタート

このサーバーを使えば、Claude を通じてオランダの鉄道旅行情報をリアルタイムで取得できます。以下にインストール方法と使用例を説明します。

✨ 主な機能

• リアルタイム列車情報：最新の列車時刻表、遅延や運休情報を取得できます。
• 駅詳細：駅の施設、無障害通路情報、OV - fiets（自転車レンタル）の利用可能性を確認できます。
• 運賃情報：異なる旅行クラス（1等席と2等席）の運賃を比較し、団体割引や特典を利用できます。

📦 インストール

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

1. Claude デスクトップ版の NPM パッケージを使用する

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"
      }
    }
  }
}

NS API キーは NS API ポータル から取得できます。

2. Smithery を使用する

Smithery を通じて NS 旅行情報サーバーを自動インストールします。

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": [
        "./ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

🔧 技術詳細

環境変数

💻 使用例

基本的な使用法

# 例：リアルタイム列車情報を照会する
curl -X POST http://localhost:7001/ns-train-info \
     -H "Content-Type: application/json" \
     -d '{"station":"Amsterdam"}'

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。