DNDzgz MCP 服务器

这是一个MCP（Model Context Protocol）服务器，它通过DNDzgz API提供关于萨拉戈萨电车系统的信息，包括实时电车到达估计时间和车站信息。

安装

1. 克隆仓库：
   bash
   git clone https://github.com/danilat/mcp-dndzgz.git
   cd mcp-dndzgz

2. 安装依赖项：
   bash
   npm install

运行应用程序

添加一个环境变量，并设置有效的Google Maps API密钥
bash
GOOGLE_MAPS_API_KEY=your-api-key

启动服务器：
bash
npm start

或者在您的MCP客户端中进行配置，例如：
json
{
"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 (数字): 按接近度排序的经度
   • 返回: 包含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的例子截图