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 许可证。
Scan to join WeChat group