Hong Kong Bus

by kennyckk

3 stars

225 downloads

Not rated

GitHub

About

Provides real-time Hong Kong bus information through KMB API integration, enabling users to find routes, locate stops, and check arrival times through conversational queries.

Details

Author: kennyckk
Repository: kennyckk/mcp_hkbus
GitHub stars: 3
Downloads: 225
License: Apache License 2.0
Categories: AI, Design, Developer Tools, Search, Frontend, Knowledge Base, API, Other
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Hong Kong Bus

Command (node, npx, python, etc.) path/to/uv.exe
Arguments
- Argument 1 --directory
- Argument 2 path/to/kmb_bus
- Argument 3 run
- Argument 4 kmb_mcp.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

JSON

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

From the repository

1. Edit the Config in your MCP Client (e.g. Claude Desktop):

{
  "mcpServers": {
    "bus_service": {
      "command": "path/to/uv.exe",
      "args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
      "background": true
    }
  }
}

2. The server provides several tools that can be used by Language Models to query bus information:

- get_route_list(): Get a list of all bus routes
- get_stop_list(): Get a list of all bus stops
- get_route_stops(): Get stops for a specific route
- find_stops_by_name(): Search for bus stops by name
- get_all_routes_at_stop(): Get all routes serving a specific stop
- get_eta(): Get estimated arrival times

To install KMB Bus MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kennyckk/mcp_hkbus --client claude

1. First, install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repository:

git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus

3. Use uv to handle the python package:

uv sync #using uv.lock

`get_route_list`

Get a list of all bus routes.

`get_stop_list`

Get a list of all bus stops.

`get_route_stops`

Get stops for a specific route.

`find_stops_by_name`

Search for bus stops by name.

`get_all_routes_at_stop`

Get all routes serving a specific stop.

`get_eta`

Get estimated arrival times.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hong kong bus": {
            "env": {},
            "args": [
                "--directory",
                "path/to/kmb_bus",
                "run",
                "kmb_mcp.py"
            ],
            "command": "path/to/uv.exe",
            "background": true
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "--directory",
        "path/to/kmb_bus",
        "run",
        "kmb_mcp.py"
    ],
    "command": "path/to/uv.exe",
    "background": true
}

Macos

{
    "env": [],
    "args": [
        "--directory",
        "path/to/kmb_bus",
        "run",
        "kmb_mcp.py"
    ],
    "command": "path/to/uv.exe",
    "background": true
}

Windows

{
    "env": [],
    "args": [
        "--directory",
        "path/to/kmb_bus",
        "run",
        "kmb_mcp.py"
    ],
    "command": "path/to/uv.exe",
    "background": true
}

KMB Bus MCP Server

A Model Context Protocol (MCP) server that provides real-time access to Hong Kong's KMB (九龍巴士) and Long Win Bus (龍運巴士) route information and arrival times. This server enables Language Models to query Hong Kong bus service information to answer user questions about bus routes, stops, and estimated arrival times.

Features

Data Source

This project utilizes the official KMB/LWB Open Data API:

- Base URL: https://data.etabus.gov.hk/v1/transport/kmb
- KMB Open Data API Documentation

Prerequisites

- Python 3.10 or higher
- uv package manager

Installation

Installing via Smithery

To install KMB Bus MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kennyckk/mcp_hkbus --client claude

Manual Installation

1. First, install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the repository:

git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus

3. Use uv to handle the python package:

uv sync #using uv.lock

Usage

1. Edit the Config in your MCP Client (e.g. Claude Desktop):

{
  "mcpServers": {
    "bus_service": {
      "command": "path/to/uv.exe",
      "args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
      "background": true
    }
  }
}

2. The server provides several tools that can be used by Language Models to query bus information:

Testing

Run the test suite using pytest:

pytest test/kmb-mcp-tests.py

Dependencies

- httpx: For async HTTP requests
- fastmcp: For MCP server implementation
- pytest: For testing (development only)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

- KMB/LWB for providing the open data API
- The MCP protocol developers

Note

This service relies on the KMB/LWB Open Data API. Please be mindful of API rate limits and implement appropriate error handling in production environments.29:["$","div",nu

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_route_list

get_stop_list

get_route_stops

find_stops_by_name

get_all_routes_at_stop

get_eta

Claude Desktop / Cursor

Linux

Macos

Windows

KMB Bus MCP Server

Features

Data Source

Prerequisites

Installation

Installing via Smithery

Manual Installation

Usage

Testing

Dependencies

Contributing

Acknowledgments

Note

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`get_route_list`

`get_stop_list`

`get_route_stops`

`find_stops_by_name`

`get_all_routes_at_stop`

`get_eta`