futu-stock Skill

This skill provides dynamic access to the Futu stock market data MCP server, supporting real-time quotes, historical K-lines, options data, and account information for Hong Kong, US, and China stock markets.

Prerequisites

Before using this skill, you need to set up two components:

1. Install futu-stock-mcp-server

Install the MCP server package:

pip install futu-stock-mcp-server

Repository: https://github.com/shuizhengqi1/futu-stock-mcp-server

After installation, verify the command is available:

which futu-mcp-server
# or
futu-mcp-server --help

2. Install and Configure Futu OpenD

Futu OpenD is the gateway service that connects to Futu's trading platform. You must install and run it before using this skill.

Installation Guide: https://openapi.futunn.com/futu-api-doc/opend/opend-cmd.html

Quick Setup Steps:

1. Download OpenD for your platform (Windows/MacOS/CentOS/Ubuntu)
2. Extract the package and locate:
   • FutuOpenD.xml (or OpenD.xml) - Configuration file
   • Appdata.dat - Required data file
3. Configure FutuOpenD.xml:
   • Set login_account: Your Futu account (platform ID, email, or phone)
   • Set login_pwd: Your login password (or use login_pwd_md5 for MD5 hash)
   • Set api_port: API port (default: 11111)
   • Set ip: Listen address (default: 127.0.0.1)
4. Test Run: Start OpenD once to verify configuration:

   # Windows
   FutuOpenD.exe
   
   # Linux
   ./FutuOpenD
   
   # MacOS
   ./FutuOpenD.app/Contents/MacOS/FutuOpenD
   

5. Background Start: Once verified, start OpenD in background using nohup:

   # Linux/MacOS
   nohup ./FutuOpenD > opend.log 2>&1 &
   
   # Or with specific config file
   nohup ./FutuOpenD -cfg_file=/path/to/FutuOpenD.xml > opend.log 2>&1 &
   

Important Notes:

• OpenD must be running before using this skill
• Default API port is 11111 (configure in FutuOpenD.xml)
• Ensure OpenD is accessible at the configured FUTU_HOST and FUTU_PORT
• For production use, consider using a process manager (systemd, supervisor, etc.) instead of nohup

3. Verify Setup

After both components are installed:

1. Check OpenD is running:

   # Check if port is listening
   netstat -an | grep 11111
   # or
   lsof -i :11111
   

2. Test MCP server connection:

   # Set environment variables
   export FUTU_HOST=127.0.0.1
   export FUTU_PORT=11111
   
   # Test MCP server
   futu-mcp-server
   

If everything is configured correctly, you can now use this skill.

Complete Setup Workflow

Summary of the complete setup process:

1. Install futu-stock-mcp-server:

   pip install futu-stock-mcp-server