Hk Transportation MCP Server

🚀 Hong Kong transportation Data MCP Server

This is an MCP server that offers access to Hong Kong's transportation - related data via a FastMCP interface.

🚀 Quick Start

To get started with this project, follow these steps:

1. Clone this repository
2. Install Python dependencies:

   pip install -r requirements.txt
   

3. Run the server:

   python app.py
   

Running Options

• Default stdio mode: python app.py
• SSE mode (port 8000): python app.py --sse

✨ Features

Passenger Traffic Statistics

• Retrieve daily passenger traffic statistics at Hong Kong control points. You can filter data by date ranges and break down statistics by visitor types (Hong Kong Residents, Mainland Visitors, Other Visitors).

Real - time Arrival Data of Kowloon Motor Bus and Long Win Bus Services

• Obtain all bus routes of Kowloon Motor Bus (KMB) and Long Win Bus Services. You can filter by language (English, Traditional Chinese, Simplified Chinese).

📦 Data Source

• Passenger traffic data from Hong Kong Immigration Department
• Bus route data from Kowloon Motor Bus and Long Win Bus Services

💻 Usage Examples

• How many Hong Kong arrivals were there yesterday through the high - speed railway.
• Get all KMB/LWB bus routes in Traditional Chinese.

📚 Documentation

Cline Integration

To connect this MCP server to Cline using stdio:

1. Add this configuration to your Cline MCP settings (cline_mcp_settings.json):

{
  "hk - transportation": {
    "disabled": false,
    "timeout": 3,
    "type": "stdio",
    "command": "uvx",
    "args": [
      "hkopenai.hk - transportation - mcp - server"
    ]
  }
}

Testing

Tests are available in the tests/ directory. Run with:

pytest

📄 License

This project is licensed under the MIT License.