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 线/蜡烛图数据

• moomoo_order_book — 实时订单簿

• moomoo_ticker — 最近的逐笔成交记录

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

更改 MCP 配置后重启 Codex，然后调用 moomoo_connection_status。

数据与安全说明

• 可用性、延迟、深度和覆盖范围取决于 OpenD、账户地区、交易所交易时间和行情权限。

• 订阅配额由 Futu 强制执行。

• 返回的数据仅供参考，不构成投资建议。

• 请勿将 OpenD 暴露到公共互联网。请将其保留在 localhost 或可信的私有网络上。

开发

pip install -e ".[dev]"
pytest

许可证

MIT