futu-opend-mcp

# futu-opend-mcp An MCP server that exposes Futu OpenD's **read-only investment-research** quote APIs (stock/option/warrant/futures prices, financials, news/announcements, shareholders, institutions, macro) as MCP tools. It borrows your already-running, logged-in Futu OpenD gateway - no separate auth. No trading, no subscriptions. It wraps the [official Futu skill pack](https://openapi.futunn.com/skills/opend-skills.zip) unmodified, so it stays in sync with Futu's own field-parsing logic. ## Install & run ### Claude Code / Claude Desktop (stdio) ``` claude mcp add futu-opend-mcp -- uvx futu-opend-mcp ``` Or from git before a PyPI release: ``` claude mcp add futu-opend-mcp -- uvx --from git+https://github.com/ER-EPR/futu-opend-mcp futu-opend-mcp ``` ### Open WebUI via mcpo (HTTP) ``` uvx mcpo --port 8000 -- futu-opend-mcp # OpenAPI at http://localhost:8000, docs at /docs ``` ### MCP JSON config Add to `~/.claude/settings.json`, `.mcp.json`, or Claude Desktop config: **Remote OpenD (with encryption):** ```json { "mcpServers": { "futu-opend": { "command": "uvx", "args": ["futu-opend-mcp"], "env": { "FUTU_OPEND_HOST": "your-opend-host", "FUTU_OPEND_PORT": "11111", "FUTU_OPEND_ENCRYPT": "true", "FUTU_OPEND_RSA_KEY": "-----BEGIN RSA PRIVATE KEY-----\\nMIIC...\\n-----END RSA PRIVATE KEY-----" } } } } ``` **Local OpenD (no encryption):** ```json { "mcpServers": { "futu-opend": { "command": "uvx", "args": ["futu-opend-mcp"], "env": { "FUTU_OPEND_ENCRYPT": "false" } } } } ``` Extract the RSA key for the env var: ```bash docker exec futu-opend cat /rsa/rsa_private_pkcs1.pem | awk '{printf "%s\\n", $0}' ``` ## Configuration (env vars) | Var | Default | Purpose | |---|---|---| | `FUTU_OPEND_HOST` | `127.0.0.1` | OpenD host | | `FUTU_OPEND_PORT` | `11111` | OpenD port | | `FUTU_OPEND_RSA_KEY` | - | inline PEM of the shared RSA private key | | `FUTU_OPEND…