MCP Dndzgz

🚀 DNDzgz MCP 服務器

這是一個藉助 DNDzgz API，提供薩拉戈薩有軌電車系統信息的 MCP（模型上下文協議）服務器。它能為用戶提供即時有軌電車到達估計和車站信息，十分實用。

🚀 快速開始

安裝指南

克隆倉庫

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

安裝依賴項

npm install

運行應用程序

添加 Google Maps API 密鑰

添加一個有效的 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 協議獲取薩拉戈薩交通系統（有軌電車、公交和自行車租賃）的即時信息，並提供地理位置服務。