DragonMCP

What arthurpanhku/DragonMCP MCP server does

The arthurpanhku/DragonMCP MCP server gives MCP clients access to live public data for Hong Kong and selected Mainland China use cases. Its Hong Kong tools cover MTR journey planning, real-time arrivals, current weather, and active weather warnings. Its Mainland China tools use Amap, also known as Gaode, for POI search and walking, driving, transit, and cycling directions.

The server is aimed at agents handling local travel, route lookup, and current conditions. It does not provide the broader delivery, payment, e-commerce, or government-service coverage suggested by the current listing description; the documented README focuses on the tools listed above.

How it works

AI clients communicate with the server through MCP over either stdio or HTTP. In stdio mode, MCP JSON-RPC messages use standard input and output, while diagnostics are sent to standard error. HTTP mode provides Streamable HTTP at /mcp and legacy SSE at /mcp/sse.

Each tool calls a live upstream API rather than returning mock data. Hong Kong functionality uses MTR data delivered through data.gov.hk and Hong Kong Observatory APIs. Amap functionality calls the Amap Web Service API and is limited to Mainland China. The system_run_selftest tool checks the reachability of the documented upstream sources.

MTR planning supports transfers across all 10 listed lines and accepts station names in English or Chinese. Routes minimize transfers, not total travel time, because inter-station running times are not published. Real-time arrivals apply only to the boarding leg. Tin Hau and Prince Edward do not have arrival data in the upstream feed.

Setup and configuration

The documented prerequisites are Node.js 18 or newer. A local setup clones the repository, installs dependencies with npm install, and builds the project with npm run build. The built stdio entry point is dist/stdio.js.

Hong Kong tools do not require an environment file or API key. Amap tools require the user's own Amap key, supplied through the AMAP_API_KEY environment variable. The README shows copying .env.example to .env before adding that key. Docker Compose and development scripts are also provided, including npm run dev:stdio and npm run dev.

The arthurpanhku/DragonMCP MCP server can be connected to Claude Desktop by configuring a local node command that points to the built dist/stdio.js file. The README also documents local HTTP operation and Docker Compose operation.

Tools and capabilities

• search_mtr_schedule: plans MTR journeys with transfers and returns real-time arrivals for the boarding leg.
• hk_weather_current: returns current Hong Kong weather conditions and active warnings.
• hk_typhoon_signal: reports structured typhoon, rainstorm, and other active warning status.
• search_transit_route: provides unified Hong Kong and Mainland China routing using MTR or Amap.
• system_run_selftest: checks whether the upstream services are reachable.
• amap_search_poi: searches for Mainland China points of interest.
• amap_walking_direction, amap_driving_direction, amap_transit_direction, and amap_bicycling_direction: request the corresponding Amap routes.

Limitations and notes

Cross-border journey planning is not yet implemented. East Rail reaches Lo Wu and Lok Ma Chau, but the server does not currently stitch a complete Hong Kong-to-Shenzhen itinerary. Amap tools require a separate user-provided key and do not cover Hong Kong. Upstream availability can change, and the self-test reports reachability rather than guaranteeing uninterrupted service. The project is released under the MIT license.