moomoo Marktdaten MCP

Ein schreibgeschützter Model Context Protocol-Server, der Echtzeit-Marktdaten von der offiziellen Futu OpenAPI (futu-api) für Codex und andere MCP-Clients bereitstellt.

Dieses Projekt stellt nur Marktdaten-Tools bereit. Es enthält keine Funktionen für Auftragserteilung, Konto, Positionen oder Geldtransfers.

Werkzeuge

• moomoo_connection_status — überprüft die Futu OpenD-Verbindung

• moomoo_snapshot — Marktschnappschüsse für ein oder mehrere Symbole

• moomoo_quote — abonnierte Echtzeitkurse

• moomoo_candles — aktuelle K-Linien-/Candlestick-Daten

• moomoo_order_book — Echtzeit-Orderbuch

• moomoo_ticker — aktuelle Zeit- und Verkaufsaufzeichnungen

• moomoo_search_securities — Wertpapiere nach Code oder Name suchen

Symbole verwenden das Futu-Format, zum Beispiel US.AAPL, HK.00700 und SH.600519.

Anforderungen

• Python 3.10+

• Futu OpenD installiert, angemeldet und laufend

• Die erforderliche Echtzeit-Kursberechtigung in Ihrem moomoo/Futu-Konto

Der Standard-Endpunkt von OpenD ist 127.0.0.1:11111. Dieser Server benötigt nicht Ihr moomoo-Passwort.

Installation und Ausführung

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

Optionale Umgebungsvariablen:

export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111

Codex-MCP-Konfiguration

Fügen Sie den Server mithilfe der Python-Umgebung hinzu, in der er installiert wurde:

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

Starten Sie Codex nach der Änderung der MCP-Konfiguration neu und rufen Sie dann moomoo_connection_status auf.

Daten- und Sicherheitshinweise

• Verfügbarkeit, Latenz, Tiefe und Abdeckung hängen von OpenD, der Kontoregion, den Börsenzeiten und den Kursberechtigungen ab.

• Abonnementkontingente werden von Futu durchgesetzt.

• Die zurückgegebenen Daten dienen nur zur Information und stellen keine Anlageberatung dar.

• Setzen Sie OpenD nicht dem öffentlichen Internet aus. Halten Sie es auf localhost oder einem vertrauenswürdigen privaten Netzwerk.

Entwicklung

pip install -e ".[dev]"
pytest

Lizenz

MIT