Skip to main content
Glama
moomoo-market-data-mcp

moomoo-market-data-mcp

by amao69904

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.

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-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

Available Tools

7 tools
moomoo_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

    B3.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      71
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Unified 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.
      929
      MIT
    • A
      license
      C
      quality
      C
      maintenance
      Read-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.
      53
      9
      MIT