mcp-dndzgz

🚀 DNDzgz MCP 服务器

这是一个 MCP（模型上下文协议）服务器，借助 DNDzgz API，提供萨拉戈萨有轨电车系统的相关信息，涵盖实时有轨电车到达估计和车站信息。

🚀 快速开始

安装指南

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 协议获取萨拉戈萨交通系统（有轨电车、公交和自行车租赁）的实时信息，并提供地理位置服务。