moomoo Market Data MCP

Un servidor de Model Context Protocol de solo lectura que expone datos de mercado en tiempo real de la API oficial de Futu OpenAPI (futu-api) a Codex y otros clientes MCP.

Este proyecto solo proporciona herramientas de datos de mercado. No contiene funciones de colocación de órdenes, cuentas, posiciones ni transferencia de fondos.

Herramientas

• moomoo_connection_status — verificar la conexión de Futu OpenD

• moomoo_snapshot — instantáneas de mercado para uno o más símbolos

• moomoo_quote — cotizaciones en tiempo real suscritas

• moomoo_candles — datos actuales de velas

• moomoo_order_book — libro de órdenes en tiempo real

• moomoo_ticker — registros recientes de tiempo y ventas

• moomoo_search_securities — buscar valores por código o nombre

Los símbolos usan el formato de Futu, por ejemplo US.AAPL, HK.00700 y SH.600519.

Requisitos

• Python 3.10+

• Futu OpenD instalado, con sesión iniciada y en ejecución

• La suscripción de cotizaciones en tiempo real requerida en tu cuenta de moomoo/Futu

El endpoint predeterminado de OpenD es 127.0.0.1:11111. Este servidor no necesita tu contraseña de moomoo.

Instalación y ejecución

git clone https://github.com/amao69904/moomoo-market-data-mcp.git
cd moomoo-market-data-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .
moomoo-market-data-mcp

Variables de entorno opcionales:

export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111

Configuración de Codex MCP

Añade el servidor usando el entorno de Python donde se instaló:

[mcp_servers.moomoo-market-data]
command = "/absolute/path/to/moomoo-market-data-mcp/.venv/bin/moomoo-market-data-mcp"

[mcp_servers.moomoo-market-data.env]
FUTU_OPEND_HOST = "127.0.0.1"
FUTU_OPEND_PORT = "11111"

Reinicia Codex después de cambiar la configuración de MCP y luego llama a moomoo_connection_status.

Notas sobre datos y seguridad

• La disponibilidad, latencia, profundidad y cobertura dependen de OpenD, la región de la cuenta, el horario de la bolsa y las suscripciones de cotizaciones.

• Las cuotas de suscripción son aplicadas por Futu.

• Los datos devueltos son informativos y no constituyen asesoramiento de inversión.

• No expongas OpenD a Internet público. Mantenlo en localhost o en una red privada de confianza.

Desarrollo

pip install -e ".[dev]"
pytest

Licencia

MIT