hkopenai.hk-finance-mcp-server 0.1.7

Hong Kong Finance MCP Server providing financial data tools

Hong Kong Finance Data MCP Server

This is an MCP server that provides access to finance related data in Hong Kong through a FastMCP interface.

Features

1. Monthly statistics on the number of new and active business registrations in Hong Kong
2. Quarterly statistics on residential mortgage loans in negative equity in Hong Kong
3. Credit card lending survey results in Hong Kong
4. Coin cart schedule in Hong Kong
5. Get list of hotlines for reporting loss of credit card from Hong Kong banks
6. Get information of Tender Invitation and Notice of Award of Contracts from Hong Kong Monetary Authority

Examples

• What is the number of new business registered in Hong Kong 2024?
• What is the negative loan situation in Hong Kong Q1 2025 compare with Q1 2024?
• Write a commentary about the latest residential mortgage loans in negative equity in Hong Kong
• How is current Hong Kong economy by referencing credit lending data and residential mortgage loans in negative equity?

Assume chart tool is available:

• Plot a line chart showing trend and number of new business registered each month from Jan to Dec in Hong Kong 2024.

Data Source

• Hong Kong Monetary Authority
• Hong Kong Inland Revenue Department

Setup

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

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-finance": {
    "disabled": false,
    "timeout": 3,
    "type": "stdio",
    "command": "uvx",
    "args": [
      "hkopenai.hk-finance-mcp-server"
    ]
  }
}

Testing

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

pytest