核心用法
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使用需遵守其服务条款,程序化数据获取可能触发风控限制