moomoo-market-data-mcp
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 OpenDmoomoo_snapshot— instantáneas de mercado para uno o más símbolosmoomoo_quote— cotizaciones en tiempo real suscritasmoomoo_candles— datos actuales de velasmoomoo_order_book— libro de órdenes en tiempo realmoomoo_ticker— registros recientes de tiempo y ventasmoomoo_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.
Related MCP server: TickDB MCP
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-mcpVariables de entorno opcionales:
export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111Configuració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]"
pytestLicencia
MIT
Available Tools
7 toolsmoomoo_candlesC
Return current candles. ktype examples: K_1M, K_5M, K_DAY.
Inputs: code (required), count, ktype, autype. Returns: result
moomoo_connection_statusA
Check whether the configured Futu OpenD endpoint is reachable.
Inputs: no named parameters. Returns: object
moomoo_order_bookB
Return the real-time bid/ask order book for one symbol.
Inputs: code (required), depth. Returns: object
moomoo_quoteC
Subscribe and return the latest real-time quote for each symbol.
Inputs: codes (required). Returns: result
moomoo_search_securitiesB
Search securities in a market such as US, HK, SH, or SZ.
Inputs: query (required), market (required), limit, security_type. Returns: result
moomoo_snapshotB
Get market snapshots. Symbols must look like US.AAPL or HK.00700.
Inputs: codes (required). Returns: result
moomoo_tickerC
Return recent real-time time-and-sales records for one symbol.
Inputs: code (required), count. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools target clearly distinct market data products (candles, order book, ticker, search, connection status). Snapshot and quote could be somewhat confusable since both return current market state, but their descriptions generally clarify the difference.
All tools share a consistent moomoo_ prefix and snake_case convention. Most are noun-like resource names (snapshot, quote, candles, order_book, ticker), while search_securities is the only verb_noun form, which is a minor deviation.
Seven tools is well-scoped for a market data server. Each tool covers a major data type or operation without unnecessary bloat or noticeable redundancy.
The toolset covers the core market data surface: search, current snapshots, quotes, candles, order book, and time-and-sales. Historical candle retrieval and additional market-data products like options or index constituents are absent, but these are reasonable gaps.
Maintenance
Related MCP Connectors
Unofficial Market Data App MCP — wraps the Market Data App API (marketdata.app)
Public Gate market data MCP for spot, futures, margin, options, delivery, earn, and alpha.
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
Real-time crypto market data: candles, tickers, orderbooks across 13+ exchanges via MCP.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables querying real-time and historical financial market data for stocks, options, forex, and crypto, including quotes, trades, technical indicators, and reference data through a set of MCP tools.713MIT

TickDB MCPofficial
AlicenseNot gradedqualityBmaintenanceUnified real-time & historical market data API for Forex, stocks (US/HK/A-share), crypto, indices & precious metals. Tick, order book depth & K-line via REST + WebSocket. AI-native: MCP server, Skill & CLI.929MIT- AlicenseCqualityCmaintenanceRead-only MCP server that exposes Futu OpenD's investment-research quote APIs (stocks, options, futures, financials, news, etc.) as MCP tools, leveraging an already-running OpenD gateway with no separate authentication.539MIT
- FlicenseNot gradedqualityDmaintenanceProvides stock market data (search, quotes, real-time, charts) for A-share, Hong Kong, and US stocks via MCP tools.-