DNDzgz MCP Server

DNDzgz MCP 服务

这是一个 MCP（Model Context Protocol）服务，通过 DNDzgz API 提供萨拉戈萨有轨电车系统的信息，包括实时到站时间预测和车站信息。

安装

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 传输方式启动服务： 在 MCP 客户端中使用 npx 进行配置，例如：

{
    "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 的示例截图