DNDzgz MCP Server

DNDzgz MCP サーバー

これは、DNDzgz API を使用して、サラゴサのトラムシステムに関する情報（リアルタイムのトラム到着予測や駅情報など）を提供する MCP（Model Context Protocol）サーバーです。

インストール

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

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

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

npm install

アプリケーションの実行

有効な Google Maps API キーを環境変数に追加し、HTTP トランスポートで実行します。

GOOGLE_MAPS_API_KEY=your-api-key npm start:http

サーバーが起動したら、接続できるように MCP クライアントを設定してください。

または、stdio トランスポートを使用してサーバーを起動します。 たとえば、npx を使用して MCP クライアントで設定します：

{
    "mcpServers": {
      "dndzgz": {
        "command": "npx @dndzgz/mcp",
        "env": {
          "GOOGLE_MAPS_API_KEY": "your-api-key"
        }
      }
    }
}

サーバーが起動し、MCP サーバーに接続します。

利用可能なツール

サーバーでは、次のツールを利用できます。

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

   • パラメーター：
     • station（number）：トラム駅の ID
   • 戻り値：両方向の到着予測時刻を含む JSON

2. zaragoza-tram-stations：サラゴサのすべてのトラム駅の一覧を取得します

   • パラメーター：
     • latitude（number）：近い順に駅を並べ替えるための緯度
     • longitude（number）：近い順に駅を並べ替えるための経度
   • 戻り値：場所、名称、ID などの駅情報を含む JSON

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

   • パラメーター：
     • latitude（number）：近い順にバス停を並べ替えるための緯度
     • longitude（number）：近い順にバス停を並べ替えるための経度
   • 戻り値：バス停の場所、名称、ID、路線を含む JSON

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

   • パラメーター：
     • stop（number）：バス停の ID
   • 戻り値：そのバス停を通る各路線の到着予測時刻を含む JSON

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

   • パラメーター：
     • latitude（number）：近い順に駅を並べ替えるための緯度
     • longitude（number）：近い順に駅を並べ替えるための経度
   • 戻り値：Bizi 駅の場所、名称、ID を含む JSON

6. zaragoza-bizi-estimations：Bizi 駅の自転車と空き駐輪スペースのリアルタイムの利用状況を取得します

   • パラメーター：
     • station（number）：Bizi 駅の ID
   • 戻り値：自転車と駐輪スペースの空き状況を含む JSON

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

   • パラメーター：
     • latitude（number）：場所の緯度
     • longitude（number）：場所の経度
   • 戻り値：指定した場所を表示する Google Maps の URL

8. geolocation-from-address：住所から位置情報（緯度と経度）と、見つかった住所の整形済み表記を取得します

   • パラメーター：
     • address（string）：位置を特定する住所（例："Plaza de San Francisco, Zaragoza, Spain"）
   • 戻り値：緯度、経度、信頼度、整形済み住所を含む JSON

依存関係

• @modelcontextprotocol/sdk: ^1.9.0

例

Claude Desktop を使用した例のスクリーンショットがあります。