技能介绍

要解决什么问题

把富途交易与行情能力接到 Agent 上，常见卡点不在「会不会写 MCP」，而在 futu-api + OpenD 的组合：综合账户升级后旧上下文拿不到真实数据、OpenD 版本过低、持仓查询漏传 acc_id、交易前未解锁、DataFrame 直接返回导致 MCP 序列化失败。本技能聚焦这些已验证的避坑路径，而不是替你选型整套工程框架。

技能如何帮你落地

环境与凭证：账号、交易密码、acc_id、RSA/WebSocket 密钥等一律经 .env / os.getenv() 读取，示例只用占位符。
打通连接的三条硬规则：使用 OpenSecTradeContext 且 security_firm=SecurityFirm.FUTUSECURITIES；OpenD ≥ 10.0；查询持仓/订单/成交前先 get_real_acc_id() 再传 acc_id。
第一个可用工具：提供可复制的「获取真实持仓」完整 Handler（含代码标准化 normalize_code()），并说明如何在任意 MCP 框架里注册为 tool。
扩展清单：新增工具时对照 8 项检查表（解锁交易 unlock_trade、返回值 to_dict(orient='records')、测试与现网逻辑一致等）。
市场与代码：港股 HK.、美股 US.、沪深 SH./SZ. 及对应 TrdMarket；默认 TrdEnv.REAL，模拟需显式 SIMULATE。

更细的 OpenD 部署、API 示例、MCP 对接见技能内 references/ 三份文档。

适用边界与注意点

本文只管关键避坑代码与模式；MCP 框架（FastMCP、自研 SDK 等）和整体架构由你自行决定。OpenD 与 MCP 服务建议用 start.sh 管理生命周期，避免随手 nohup/systemd 起进程。涉及真实资金时，务必在隔离环境与正确 .env 下验证后再接 Agent。