futu-stock

核心用法

futu-stock 是一个连接富途证券OpenD网关的MCP技能，提供港股、美股、A股三大市场的实时行情数据与账户信息查询能力。用户需先安装futu-stock-mcp-serverPython包并运行富途官方OpenD服务，通过环境变量配置连接地址后即可使用。

该技能采用动态加载模式，仅在调用时加载完整工具定义，显著降低上下文占用。支持20余种工具调用，包括：实时报价（get_stock_quote）、K线数据（get_cur_kline/get_history_kline）、期权链（get_option_chain）、账户持仓（get_positions）等。部分实时数据需先订阅（subscribe）再查询。

显著优点

1. 市场覆盖全面：同时支持HK（港股）、US（美股）、SH/SZ（A股）三大市场，满足跨境投资需求
2. 数据维度丰富：除基础行情外，提供期权希腊值、融资融券数据、经纪队列等专业级数据
3. 上下文效率高：相比传统MCP预加载500+token，空闲时仅占用~100token，执行时零token开销
4. 架构清晰：executor.py作为轻量级封装层，通过标准MCP协议与外部服务通信，职责分离明确

潜在缺点与局限性

1. 部署门槛高：需同时安装Python包、配置OpenD服务、设置环境变量，对非技术用户不友好
2. 依赖外部服务：OpenD必须常驻运行，服务中断则技能完全不可用
3. 数据权限受限：历史K线限30只股票/30天，单次订阅限100只代码，存在富途API本身的频率限制
4. 订阅机制复杂：实时数据需先订阅再查询，增加调用步骤和出错概率
5. 无交易功能：仅支持数据查询，不支持下单、撤单等交易操作

适合的目标群体

• 量化研究者：需要程序化获取港股/美股/A股历史与实时数据进行策略回测
• 个人投资者：希望在一个界面中监控多市场持仓和行情，已开通富途证券账户
• 开发者/金融科技从业者：需要集成富途数据源到自有系统，具备服务器运维能力

使用风险

1. 服务可用性风险：OpenD或futu-mcp-server任一组件异常将导致服务中断，建议配置进程守护
2. 数据延迟风险：行情数据经多层转发，极端行情下可能存在秒级延迟，不适合高频交易决策
3. 账户安全风险：技能可访问账户资金、持仓等敏感信息，需确保运行环境可信，避免在公共服务器部署
4. 合规风险：富途API使用需遵守其服务条款，程序化数据获取可能触发风控限制

核心用法

futu-stock 是一个基于 MCP 协议的本地行情数据接入工具，通过封装 futu-stock-mcp-server 实现与富途 OpenD 服务的通信。用户需先本地部署富途官方 OpenD 网关（配置账户、启动服务），再配置 FUTU_HOST 和 FUTU_PORT 环境变量即可调用。

支持功能覆盖：

• 实时行情：股票报价、买卖盘、逐笔成交、订单簿
• K线数据：当前K线（需订阅）、历史K线（限30只股票/30天）
• 期权数据：期权链、希腊值、蝶式/鹰式策略
• 账户信息：资金、持仓、购买力、保证金比率
• 市场状态：港股(HK)、美股(US)、上海(SH)、深圳(SZ)四大市场

使用模式采用动态加载设计：空闲时仅约100 tokens上下文，调用时按需加载完整指令，显著优于传统 MCP 预加载方式。

显著优点

1. 本地化安全架构：仅通过 TCP Socket 连接本地 OpenD 服务（127.0.0.1:11111），无外部 API 调用，数据不出本地
2. 隐私合规良好：仅读取 FUTU_HOST、FUTU_PORT 两个环境变量，符合 GDPR/CCPA 数据最小化原则
3. 依赖纯净：仅依赖官方 mcp Python 包，无已知 CVE 漏洞，无恶意包风险
4. 上下文高效：动态加载机制，空闲时 token 占用降低 80% 以上
5. 功能完整：覆盖行情、期权、账户三大模块，满足量化分析与监控需求

潜在缺点与局限性

1. 部署门槛高：必须自行安装配置富途 OpenD，涉及账户注册、XML 配置、后台服务管理等步骤
2. 依赖外部服务：OpenD 服务中断则 skill 完全不可用，稳定性受本地环境影响
3. 数据限制：历史K线限 30 只股票/30 天，订阅上限 100 只/请求、500 只/连接
4. 订阅机制复杂：实时数据需先 subscribe 再查询，两步操作增加使用成本
5. 代码量较小：仅 321 行/5 文件，功能深度依赖上游 futu-stock-mcp-server

适合人群

• 已有富途证券账户且熟悉 OpenD 部署的量化交易者
• 需要本地私有化行情数据、拒绝云端 API 的隐私敏感用户
• 具备 Linux/Mac 运维能力、能独立排查服务连接问题的技术用户
• 轻量级监控、策略回测、持仓分析等场景，非高频交易需求

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 供应链风险 | 中 | 上游 `futu-stock-mcp-server` 为个人开发者维护，建议锁定版本、审查源码、fork 后自用 |

| 配置泄露风险 | 低 | OpenD 配置文件含账户密码，需设置 600 权限、使用 MD5 加密密码 |

| 服务可用性风险 | 中 | OpenD 需常驻后台，崩溃或网络故障将导致 skill 失效 |

| 数据订阅限制 | 低 | 超出订阅上限需分批次处理，策略设计时需预留余量 |