moomoo Market Data MCP

Сервер Model Context Protocol только для чтения, который предоставляет реальные рыночные данные из официального Futu OpenAPI (futu-api) для Codex и других MCP-клиентов.

Этот проект предоставляет только инструменты рыночных данных. Он не содержит функций размещения ордеров, работы с аккаунтом, позициями или переводами средств.

Инструменты

• moomoo_connection_status — проверка подключения к Futu OpenD

• moomoo_snapshot — рыночные снимки для одного или нескольких символов

• moomoo_quote — подписанные котировки в реальном времени

• moomoo_candles — текущие данные K-line/свечей

• moomoo_order_book — книга ордеров в реальном времени

• moomoo_ticker — последние записи о сделках (time-and-sales)

• moomoo_search_securities — поиск ценных бумаг по коду или названию

Символы используют формат Futu, например US.AAPL, HK.00700 и SH.600519.

Требования

• Python 3.10+

• Установленный, авторизованный и запущенный Futu OpenD

• Необходимые права на котировки в реальном времени в вашем аккаунте moomoo/Futu

Конечная точка OpenD по умолчанию — 127.0.0.1:11111. Этот сервер не требует ваш пароль moomoo.

Установка и запуск

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

Необязательные переменные окружения:

export FUTU_OPEND_HOST=127.0.0.1
export FUTU_OPEND_PORT=11111

Конфигурация Codex MCP

Добавьте сервер, используя окружение Python, в котором он установлен:

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

Перезапустите Codex после изменения конфигурации MCP, затем вызовите moomoo_connection_status.

Примечания по данным и безопасности

• Доступность, задержка, глубина и покрытие зависят от OpenD, региона аккаунта, часов работы биржи и прав на котировки.

• Квоты на подписку устанавливаются Futu.

• Возвращаемые данные носят информационный характер и не являются инвестиционным советом.

• Не открывайте OpenD для публичного интернета. Держите его на localhost или в доверенной частной сети.

Разработка

pip install -e ".[dev]"
pytest

Лицензия

MIT