MCP Dndzgz

🚀 DNDzgz MCP サーバー

このサーバーは、DNDzgz API を使用して、サラゴサの路面電車システムの情報を提供する MCP（モデルコンテキストプロトコル）サーバーです。リアルタイムの路面電車到着予測や駅情報を含みます。

🚀 クイックスタート

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/danilat/mcp-dndzgz.git
cd mcp-dndzgz

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

npm install

💻 サーバーの起動

有効な Google Maps API キーを環境変数として追加します：

GOOGLE_MAPS_API_KEY=your-api-key

サーバーを起動します：

npm start

または、MCP クライアントで次のように設定することもできます：

{
    "mcpServers": {
        "dndzgz": {
            "command": "node",
            "args": [
                "/Users/danilat/workspace/mcp-dndzgz/index.js"
            ],
            "env": {
                "GOOGLE_MAPS_API_KEY": "your-api-key"
            }
        }
    }
}

サーバーが起動し、MCP トランスポート層に接続します。

✨ 主な機能

このサーバーは以下のツールを提供します：

1. zaragoza-tram-estimations：特定の路面電車駅のリアルタイム到着予測を取得します

   • パラメータ：
     • station (数値)：路面電車駅の ID
   • 返り値：両方向の到着時間予測を含む JSON

2. zaragoza-tram-stations：サラゴサのすべての路面電車駅の情報を取得します

   • パラメータ：
     • latitude (数値)：距離でソートするための緯度
     • longitude (数値)：距離でソートするための経度
   • 返り値：位置、名称、ID を含む駅情報の JSON

3. zaragoza-bus-stops：サラゴサのすべてのバス停の情報を取得します

   • パラメータ：
     • latitude (数値)：距離でソートするための緯度
     • longitude (数値)：距離でソートするための経度
   • 返り値：位置、名称、ID、路線を含むバス停情報の JSON

4. zaragoza-bus-estimations：特定のバス停のリアルタイム到着予測を取得します

   • パラメータ：
     • stop (数値)：バス停の ID
   • 返り値：そのバス停でサービスされるすべての路線の到着時間予測を含む JSON

5. zaragoza-bizi-stations：サラゴサのすべての Bizi 駅（公共自転車レンタルサービス）の情報を取得します

   • パラメータ：
     • latitude (数値)：距離でソートするための緯度
     • longitude (数値)：距離でソートするための経度
   • 返り値：位置、名称、ID を含む Bizi 駅情報の JSON

6. zaragoza-bizi-estimations：特定の Bizi 駅のリアルタイムの自転車と空きスロットの可用性を取得します

   • パラメータ：
     • station (数値)：Bizi 駅の ID
   • 返り値：自転車と駐車スロットの可用性を含む JSON

7. google-maps-link：特定の位置の Google Maps リンクを取得します

   • パラメータ：
     • latitude (数値)：位置の緯度
     • longitude (数値)：位置の経度
   • 返り値：指定された位置を表示する Google Maps の URL

8. geolocation-from-address：住所から地理位置情報（緯度と経度）とフォーマットされた住所を取得します

   • パラメータ：
     • address (文字列)：位置を特定する住所（例：“Plaza de España, Zaragoza”）
   • 返り値：緯度、経度、フォーマットされた住所を含む JSON

🔧 技術詳細

依存関係

• axios: HTTP リクエストクライアント
• express: Web フレームワーク
• googlemaps: Google Maps API クライアント

💻 使用例

基本的な使用法

zaragoza-tram-stations の例

[
  {
    "id": "1",
    "name": "Estación Delicias",
    "latitude": "41.6509",
    "longitude": "-0.8772"
  },
  {
    "id": "2",
    "name": "Plaza de España",
    "latitude": "41.6538",
    "longitude": "-0.8769"
  }
]

geolocation-from-address の例

{
  "latitude": "41.6509",
  "longitude": "-0.8772",
  "formatted_address": "Plaza de España, Zaragoza, Spain"
}

このサーバーを使用すると、MCP プロトコルを通じてサラゴサの交通システム（路面電車、バス、自転車レンタル）のリアルタイム情報を取得でき、地理位置情報サービスも利用できます。