DNDzgz MCP Server

这是一个提供萨拉戈萨有轨电车系统信息的MCP（模型上下文协议）服务器，包括实时到站估计和站点信息，使用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客户端中进行如下配置，例如：

{
    "mcpServers": {
      "dndzgz": {
        "command": "npx @dndzgz/mcp",
        "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 (数字): 按距离排序的经度
   • 返回值： 包含Bizi站点位置、名称和ID的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 San Francisco, Zaragoza, Spain”）
   • 返回值： 包含纬度、经度、置信水平和格式化地址的JSON

依赖项

• @modelcontextprotocol/sdk: ^1.9.0

示例

有一个使用Claude Desktop的示例截图