Futu

Provides real-time stock data and trading actions via an MCP interface for querying quotes, K-lines, funds, positions, orders, and watchlists.

python

10

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shuchaang-futu-mcp": {
      "command": "npx",
      "args": [
        "@shuchang/futu-mcp-server"
      ],
      "env": {
        "FUTU_API_HOST": "127.0.0.1",
        "FUTU_API_PORT": "11111",
        "FUTU_UNLOCK_PASSWORD": "YOUR_PASSWORD"
      }
    }
  }
}

This MCP server provides full stock data access and trading capabilities through the Futuo MCP interface, enabling you to query real-time quotes, K-line data, account information, place trades, manage orders, and organize watchlists from a local MCP client.

How to use

You run the Futuo MCP server locally and connect your MCP client to it to perform market data queries and trading actions. The server supports real-time quotes, K-line data, stock snapshots, conditional stock screening, order placement, and watchlist management. Start the server via an MCP client command and then issue your MCP requests through the client to fetch data or execute trades.

Typical usage patterns include starting the MCP server and then connecting your MCP client to the local endpoint (by default on localhost and the configured port). You can configure host, port, and optional unlock password through environment variables before starting the server to tailor it to your network and security needs.

How to install

Prerequisites you need on your machine:

Node.js version 14.0.0 or newer
Python 3.x (for any Python-based tooling or dependencies)
Futuo OpenD client and a valid Futuo account with API access

Step-by-step commands to get running from a clean environment:

# Quick start using npx (recommended)
npx @shuchang/futu-mcp-server

# Alternative: install globally and run via the CLI
npm install -g @shuchang/futu-mcp-server
futu-mcp

Additional sections

Configuration, security, and practical usage notes help you tailor the MCP server to your setup. The server can be configured to connect to Futuo OpenD via environment variables, and you should ensure your Futuo account and permissions are correctly configured before enabling trading features.

Environment variables you can configure to connect to Futuo API:

export FUTU_API_HOST=127.0.0.1
export FUTU_API_PORT=11111
export FUTU_UNLOCK_PASSWORD=your_password   # optional

Then start the MCP server with the same environment to apply these settings.

## 常见问题与注意事项

- Ensure Futuo OpenD is running and reachable from your MCP server host.

- Verify your Futuo account permissions for market data, trading, and watchlists.

- If you encounter connection issues, double-check host/port settings and network availability.

## 示例用法

在客户端演示中，你将通过 MCP 客户端请求以下功能：获取持仓、查询资金、执行条件选股等。下面给出与服务器交互的概念性示例，帮助你理解流程。

## Available tools

### GetPositions

Retrieve current holdings for the connected trading account.

### GetFunds

Query available funds and account balance.

### GetStockFilter

Apply criteria to screen stocks based on market data and indicators.