home / mcp / hong kong creative goods trade mcp server

Hong Kong Creative Goods Trade MCP Server

This is an MCP server that provides access to recreation, sports and culture data in Hong Kong through a FastMCP interface.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hkopenai-hk-recreation-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  }
}

You can access Hong Kong’s Creative Goods trade data through a lightweight MCP server that exposes Domestic Exports, Re-exports, and Imports of Creative Goods in Hong Kong. It runs locally or via a managed MCP bridge, enabling you to query and integrate these statistics into your analytics pipelines or apps with standard MCP clients.

How to use

Connect to the MCP server using your MCP client as you would with any standard MCP endpoint. The server provides three primary data endpoints you can query: domestic_exports, re_exports, and imports. You can filter the data by a year range to focus on a specific period. Use your client’s normal request flow to request the data you need and then handle the results in your application.

How to install

Prerequisites you need before starting:

Python 3.8+ must be installed on your system
pip must be available to install dependencies

Steps to install and start the MCP server locally:

Clone the repository at hkopenai/hk-recreation-mcp-server
Navigate to the project directory
Install Python dependencies: pip install -r requirements.txt
Run the server: python server.py

Additional sections

Configuration and running options are described below. The server can run in the default stdio mode or in SSE mode for streaming data. If you integrate with Cline or another MCP orchestrator, you can use the stdio configuration to launch the server from your MCP runner.

Configuration and integration notes

Cline integration provides a ready-made stdio configuration to connect the HK Recreation MCP server. The runner can be launched via uvx with a specific module name to expose the MCP endpoint.

Testing

To verify the server and its data endpoints, run the test suite from the project: pytest.

Available tools

creative_goods_trade_query

Query the domestic exports, re-exports, and imports of creative goods in Hong Kong with an optional year-range filter. Returns aggregated trade statistics suitable for reporting and analysis.