What I do
I help you plan public transit trips anywhere in the world by connecting to the Wheels Router MCP server.
For Hong Kong trips, I use the Wheels Router API which provides:
- - Detailed routing with MTR, bus, tram, ferry, and walking
- Real-time schedules and accurate fares
- Platform information and exit details
- Interchange discounts (轉乘優惠) when available
For worldwide trips, I use the Transitous API which covers:
- - Major cities globally with transit data
- Basic routing with public transportation
- Walking directions and transfers
When to use me
Use this skill whenever you need to:
- - Plan a trip using public transportation
- Find the best route between two locations
- Check transit schedules and connections
- Get fare estimates for Hong Kong transit
- Search for locations before planning routes
Examples:
- - "How do I get from Yau Tong MTR to Hong Kong Airport?"
- "What's the best way to Central from Causeway Bay right now?"
- "Plan a trip from Tokyo Station to Shibuya"
- "Search for locations near Victoria Park"
How to connect
If you're using mcporter (clawdbot, etc.)
Follow your mcporter skill, if you don't have one follow below:
Add to config/mcporter.json:
CODEBLOCK0
Then call tools directly:
CODEBLOCK1
For other MCP clients
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
CODEBLOCK2
Cursor/Windsurf/VS Code (.cursor/mcp.json or similar):
CODEBLOCK3
Available tools
search_location
Search for places before planning trips. Always use this first if you don't have exact coordinates.
Parameters:
- -
query (required): Place name or address (e.g., "Hong Kong Airport", "Yau Tong MTR Exit A2") - INLINECODE5 (optional): Number of results (1-10, default 5)
Example:
CODEBLOCK4
Returns:
- -
display_name: Full address - INLINECODE7 ,
lon: Coordinates for use in INLINECODE9 - INLINECODE10 ,
class: Location category
plan_trip
Plan a transit route between two points.
Parameters:
- -
origin (required): Starting point as "lat,lon" or INLINECODE15 - INLINECODE16 (required): Ending point as
"lat,lon" or INLINECODE18 - INLINECODE19 (optional): ISO 8601 departure time (e.g.,
"2026-01-26T10:00:00+08:00") - INLINECODE21 (optional): ISO 8601 arrival deadline
- INLINECODE22 (optional): Comma-separated modes like
"mtr,bus,ferry" (only specify if needed) - INLINECODE24 (optional): Limit number of route options (1-5)
Example:
CODEBLOCK5
Returns:
- -
plans: Array of route options
-
duration_seconds: Total trip time
-
fares_min,
fares_max: Fare range in HKD (Hong Kong only)
-
legs: Step-by-step directions
-
type: "walk", "transit", "wait", "station_transfer"
- Transit legs include: route name, headsign, stops, platform info
- Walk legs include: distance, duration
Best practices
- 1. Always search first: Use
search_location to find coordinates before calling INLINECODE32 - Use coordinates: Plan trips with
lat,lon format for best results - Specify times: Include
depart_at or arrive_by for accurate schedules - Check multiple options: Request 2-3 route options with INLINECODE36
- Understand fares:
fares_min and fares_max show the range—interchange discounts are noted separately when available
Important notes
- - Interchange discounts (轉乘優惠): Only shown when explicitly present in Hong Kong routes, not all routes qualify
- Real-time data: Hong Kong routes use live schedules; worldwide coverage may vary
- Time zones: Use UTC or local timezone offsets (HKT is UTC+8)
- Coverage: Best for Hong Kong; worldwide coverage varies by city
Example workflow
CODEBLOCK6
Error handling
- - "Could not find location": Try a more specific search query
- "No routes found": Check if coordinates are valid and in a covered area
- "Invalid time format": Ensure ISO 8601 format with timezone
- Rate limits: Be mindful of API usage, cache results when appropriate
Coverage areas
- - ✅ Full coverage: Hong Kong (MTR, bus, tram, ferry, detailed fares)
- ✅ Good coverage: Major global cities with Transitous data
- ⚠️ Limited coverage: Smaller cities may have incomplete transit data
我的功能
我通过连接 Wheels Router MCP 服务器,帮助您规划全球任何地方的公共交通行程。
对于香港行程,我使用 Wheels Router API,提供:
- - 包含港铁、巴士、电车、渡轮和步行的详细路线规划
- 实时时刻表和准确票价
- 月台信息和出口详情
- 可用的转乘优惠
对于全球行程,我使用 Transitous API,覆盖:
- - 全球主要城市的公共交通数据
- 基本的公共交通路线规划
- 步行指引和换乘信息
使用时机
当您需要以下服务时,请使用此技能:
- - 规划公共交通行程
- 查找两地之间的最佳路线
- 查询公共交通时刻表和换乘信息
- 获取香港交通的票价估算
- 在规划路线前搜索地点
示例:
- - 如何从油塘港铁站前往香港机场?
- 现在从中环到铜锣湾的最佳路线是什么?
- 规划从东京站到涩谷的行程
- 搜索维多利亚公园附近的地点
连接方式
如果您使用 mcporter(clawdbot 等)
请遵循您的 mcporter 技能说明,如果没有,请按以下步骤操作:
添加到 config/mcporter.json:
json
{
mcpServers: {
wheels-router: {
description: 规划全球公共交通行程,
baseUrl: https://mcp.justusewheels.com/mcp
}
}
}
然后直接调用工具:
bash
npx mcporter call wheels-router.search_location query=香港机场
npx mcporter call wheels-router.plan_trip origin=22.28,114.24 destination=22.31,113.92
对于其他 MCP 客户端
Claude Desktop (~/Library/Application Support/Claude/claudedesktopconfig.json):
json
{
mcpServers: {
wheels-router: {
command: npx,
args: [mcp-remote, https://mcp.justusewheels.com/mcp]
}
}
}
Cursor/Windsurf/VS Code (.cursor/mcp.json 或类似文件):
json
{
mcpServers: {
wheels-router: {
command: npx,
args: [mcp-remote, https://mcp.justusewheels.com/mcp]
}
}
}
可用工具
search_location
在规划行程前搜索地点。如果您没有精确坐标,请始终先使用此工具。
参数:
- - query(必填):地点名称或地址(例如:香港机场、油塘港铁站A2出口)
- limit(可选):结果数量(1-10,默认5)
示例:
javascript
search_location({
query: 香港国际机场,
limit: 3
})
返回结果:
- - displayname:完整地址
- lat、lon:用于 plantrip 的坐标
- type、class:地点类别
plan_trip
规划两点之间的公共交通路线。
参数:
- - origin(必填):起点,格式为 lat,lon 或 stop:ID
- destination(必填):终点,格式为 lat,lon 或 stop:ID
- departat(可选):ISO 8601 格式的出发时间(例如 2026-01-26T10:00:00+08:00)
- arriveby(可选):ISO 8601 格式的到达截止时间
- modes(可选):逗号分隔的交通方式,如 mtr,bus,ferry(仅在需要时指定)
- max_results(可选):限制路线选项数量(1-5)
示例:
javascript
plan_trip({
origin: 22.2836,114.2358,
destination: 22.3080,113.9185,
depart_at: 2026-01-26T14:30:00+08:00,
max_results: 3
})
返回结果:
- duration_seconds:总行程时间
- fares
min、faresmax:票价范围(仅限香港,单位为港币)
- legs:逐步指引
- type:walk(步行)、transit(公共交通)、wait(等待)、station_transfer(站内换乘)
- 公共交通段包括:路线名称、终点方向、站点、月台信息
- 步行段包括:距离、时长
最佳实践
- 1. 始终先搜索:在调用 plantrip 前,使用 searchlocation 查找坐标
- 使用坐标:以 lat,lon 格式规划行程可获得最佳效果
- 指定时间:包含 departat 或 arriveby 以获取准确的时刻表
- 查看多个选项:使用 maxresults 请求2-3条路线选项
- 理解票价:faresmin 和 fares_max 显示票价范围——转乘优惠在有可用时会单独标注
重要说明
- - 转乘优惠:仅在香港路线中明确存在时显示,并非所有路线都符合条件
- 实时数据:香港路线使用实时时刻表;全球覆盖范围可能有所不同
- 时区:使用 UTC 或当地时区偏移(香港时间为 UTC+8)
- 覆盖范围:香港覆盖最佳;全球覆盖范围因城市而异
示例工作流程
javascript
// 1. 搜索地点
const origins = await search_location({
query: 油塘港铁站,
limit: 1
});
const destinations = await search_location({
query: 香港机场,
limit: 1
});
// 2. 规划行程
const routes = await plan_trip({
origin: ${origins[0].lat},${origins[0].lon},
destination: ${destinations[0].lat},${destinations[0].lon},
depart_at: 2026-01-26T15:00:00+08:00,
max_results: 2
});
// 3. 向用户展示最佳选项,或仅在用户明确要求时展示具体结果。默认情况下,只需提供类似 [步行] > [3D] > [步行] > [观塘线] > [步行] 的信息——除非用户要求具体细节。
错误处理
- - 找不到地点:尝试使用更具体的搜索查询
- 未找到路线:检查坐标是否有效且在覆盖区域内
- 时间格式无效:确保使用带时区的 ISO 8601 格式
- 速率限制:注意 API 使用量,适当缓存结果
覆盖区域
- - ✅ 全面覆盖:香港(港铁、巴士、电车、渡轮、详细票价)
- ✅ 良好覆盖:拥有 Transitous 数据的全球主要城市
- ⚠️ 有限覆盖:较小城市的公共交通数据可能不完整