HK Finance

v1.0.0Finance & Fintechstable

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

aifinancehongkongmcp
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is HK Finance?

HK Finance is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to this is an mcp server that provides access to finance related data in hong kong through a fastmcp interface.

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

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • This is an MCP server that provides access to finance relate

Use Cases

Access Hong Kong financial data
Query market and economic information
hkopenai

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedFeb 13, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx hk-finance

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use HK Finance

The HK Finance MCP Server provides AI assistants with access to Hong Kong financial and economic data sourced from public datasets published by the Hong Kong Monetary Authority and related government agencies. It exposes tools for retrieving HIBOR interbank interest rates, residential mortgage statistics, credit card lending survey data, business registration figures, ATM and bank branch locations, stamp duty collections, and fraudulent website reports. Financial analysts, researchers, and developers building Hong Kong market applications use it to query official monetary data in real time through natural-language prompts.

Prerequisites

  • Python 3.9+ installed
  • pip available in your PATH
  • Internet access to reach DataGovHK and HKMA public APIs
  • No API keys required (data sourced from public government datasets)
  • An MCP-compatible client such as Claude Desktop or Cline
1

Clone the repository

Clone the hk-finance-mcp-server repository from GitHub.

git clone https://github.com/hkopenai/hk-finance-mcp-server.git
cd hk-finance-mcp-server
2

Install Python dependencies

Install all required packages. The server uses FastMCP and httpx to interface with Hong Kong government data APIs.

pip install -r requirements.txt
3

Start the server in stdio mode

Launch the server in the default stdio mode for use with MCP clients like Claude Desktop.

python server.py
4

Alternatively, start in SSE mode

Start the server in SSE (Server-Sent Events) mode on port 8000 for use with remote agents or HTTP-based MCP clients.

python server.py --sse
5

Add to your MCP client configuration

Register the server in your Claude Desktop or Cline MCP configuration. The uvx form allows running without a local clone using the published package.

HK Finance Examples

Client configuration

Cline or Claude Desktop configuration using uvx to run the published hkopenai.hk-finance-mcp-server package without cloning.

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

Prompts to try

Example natural-language prompts for querying Hong Kong financial data through an AI assistant.

- "What is today's HIBOR overnight rate?"
- "Show me residential mortgage loan statistics for the last two quarters."
- "How many new business registrations were there in Hong Kong in 2024?"
- "Find ATMs in Kowloon that support USD withdrawal."
- "What is the latest credit card lending survey data from Hong Kong?"
- "Show me stamp duty collection figures for the last 12 months."

Troubleshooting HK Finance

Server returns empty results or network timeout errors

The server fetches data from DataGovHK and HKMA public APIs in real time. Verify you have internet connectivity and that https://api.data.gov.hk is reachable from your machine. Government APIs may occasionally be slow; increase timeout in the client config (e.g., set timeout to 30 seconds).

uvx command not found when using the Cline config

Install uv which provides the uvx command: `curl -LsSf https://astral.sh/uv/install.sh | sh`. Alternatively, use the local clone approach with `python server.py` as the command instead.

pytest fails when running tests

Run pytest from the tests directory: `cd tests && pytest`. Ensure all dependencies from requirements.txt are installed in your active Python environment before running tests.

Frequently Asked Questions about HK Finance

What is HK Finance?

HK Finance is a Model Context Protocol (MCP) server that this is an mcp server that provides access to finance related data in hong kong through a fastmcp interface. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install HK Finance?

Follow the installation instructions on the HK Finance GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with HK Finance?

HK Finance works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is HK Finance free to use?

Yes, HK Finance is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "hk-finance": { "command": "npx", "args": ["-y", "hk-finance"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use HK Finance?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides