Transport NSW API Client (MCP Implementation)

Transport NSW API Client (MCP Implementation)

site icon
2025.03.22 0
Python交通数据API客户端位置服务
Transport NSW API Client (MCP Implementation) 是一个基于Model Context Protocol (MCP)的服务,用于与Transport NSW API进行交互。它提供了查找交通站点、获取交通警报和实时出发信息等功能,适用于需要访问澳大利亚新南威尔士州交通数据的开发者和AI模型。
View on GitHub

Overview

基本能力

产品定位

Transport NSW API Client (MCP Implementation) 是一个基于Model Context Protocol (MCP)的服务,用于与Transport NSW API进行交互。

核心功能

  • Stop Finder API: 通过名称或坐标查找交通站点
  • Alerts API: 获取交通警报和中断信息
  • Departure Monitor API: 获取交通站点的实时出发信息
  • MCP Implementation: 作为Model Context Protocol服务结构化

适用场景

  • 开发需要访问澳大利亚新南威尔士州交通数据的应用程序
  • AI模型需要通过标准化接口访问交通数据
  • 实时监控交通站点出发信息
  • 获取交通警报和中断信息

工具列表

  • find_transport_stops: 查找交通站点
  • get_transport_alerts: 获取交通警报
  • get_departure_monitor: 监控实时出发信息
  • demo.py: 展示所有API功能的演示脚本

常见问题解答

  • 如何获取API密钥?需要创建.env文件并添加OPEN_TRANSPORT_API_KEY
  • 如何运行测试?使用uv run pytest命令
  • 如何运行演示脚本?使用python demo.py命令

使用教程

使用依赖

  1. 克隆仓库
  2. 使用uv安装依赖: bash uv venv uv sync

安装教程

  1. 创建.env文件并添加API密钥: OPEN_TRANSPORT_API_KEY=your_api_key_here
  2. (可选) 运行MCP Inspector: bash uv run mcp dev api.py 访问服务器 http://localhost:5173 (端口可能不同)

调试方式

  1. 运行完整测试套件: bash uv run pytest
  2. 带覆盖率报告的测试: bash uv run pytest --cov=api
  3. 运行演示脚本: bash python demo.py

许可证

None