基于富途官方OpenD网关的港股/美股/A股实时行情与账户管理工具,支持K线、期权、持仓查询,需本地部署服务。
说明:
## 核心用法
futu-stock 是一个连接富途证券OpenD网关的MCP技能,提供港股、美股、A股三大市场的实时行情数据与账户信息查询能力。用户需先安装`futu-stock-mcp-server`Python包并运行富途官方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使用需遵守其服务条款,程序化数据获取可能触发风控限制







