微信扫一扫article
README
🚀 香港交通数据MCP服务器
这是一个MCP服务器，可通过FastMCP接口提供香港交通相关数据的访问服务，为用户了解香港交通状况提供便利。
🚀 快速开始
安装与启动
- 克隆本仓库。
- 安装Python依赖：
pip install -r requirements.txt - 运行服务器：
python app.py
运行选项
- 默认标准输入输出模式：
python app.py - SSE模式（端口8000）：
python app.py --sse
✨ 主要特性
客流量统计
- 获取香港各管制站的每日客流量统计数据。可按日期范围筛选数据，还能按访客类型（香港居民、内地访客、其他访客）细分统计。
九龙巴士和龙运巴士服务实时到站数据
- 获取九龙巴士（KMB）和龙运巴士服务的所有公交线路信息。可按语言（英语、繁体中文、简体中文）进行筛选。
📦 安装指南
按照上述“快速开始”中的步骤进行操作，即可完成服务器的安装与启动。
💻 使用示例
基础用法
# 示例：查询昨日通过高铁抵达香港的人数
# 代码逻辑可根据实际接口调用实现
高级用法
# 示例：以繁体中文获取所有九龙巴士/龙运巴士的公交线路
# 代码逻辑可根据实际接口调用实现
📚 详细文档
数据源
- 客流量数据来自香港入境事务处。
- 公交线路数据来自九龙巴士和龙运巴士服务。
客户端集成
若要使用标准输入输出将此MCP服务器连接到Cline，可按以下步骤操作：
在你的Cline MCP设置文件（cline_mcp_settings.json）中添加如下配置：
{
"hk-transportation": {
"disabled": false,
"timeout": 3,
"type": "stdio",
"command": "uvx",
"args": [
"hkopenai.hk-transportation-mcp-server"
]
}
}
测试
测试代码位于tests/目录下，可使用以下命令运行测试：
pytest
📄 许可证
本项目采用 MIT 许可证。