前言¶

富途有官方 API（futu-api），但没有官方 MCP 服务。Agent 要读行情、查持仓、下单，要么自己去啃 futu-api 的连接与鉴权细节，要么把第三方仓库直接拉进来跑——后者在真实交易场景下要承担代码来源的风险。futu-mcp-guide 这个 Skill 的作用，是把从打通 OpenD 到注册第一个 MCP 工具之间的坑先踩一遍，把关键代码和结论交给你。

这是什么¶

futu-mcp-guide 是一个面向开发者的 Skill，坐标 @user_b785198a/futu-mcp-guide，版本 1.0.0，来源 community，分类 dev-programming，发布者 user_b785198a。

它解决的是这个问题：富途官方尚未提供 MCP 服务，开发者需要用 futu-api 自行实现一个可被 Agent 调用的富途 MCP。Skill 提供从打通 OpenD 连接、到注册第一个 MCP 工具的关键代码与踩坑经验。

背景上有一点值得说明：此前可用的是长桥的 MCP，但长桥证券已不支持新开户；GitHub 上已有富途 MCP 项目 futu-stock-mcp-server。Skill 的介绍里明确建议，真实交易场景为安全起见避免直接使用来路不明的实现，自己搭建开发更稳妥。这个 Skill 帮你少踩一些坑。

核心功能¶

下面列出的是从官方页面核实到的能力范围，全部围绕「用 futu-api 自建富途 MCP」。

1、打通 OpenD 连接：OpenD 是本地行情与交易网关，Skill 覆盖连接建立这一步的坑。
2、注册第一个 MCP 工具：从连接打通到工具可被 Agent 调用的最小可用路径。
3、关键代码与踩坑经验：面向有 Python / MCP 经验的开发者，拿到就能用 futu-api 实现 futu MCP。
4、触发场景覆盖：开发富途 MCP 工具、调用 futu-api 编写行情或交易代码、调试 OpenD 连接、处理综合账户持仓查询、标准化股票代码，以及任何涉及港股 / 美股 / A 股数据开发的场景。

安装与启用¶

官方页面没有给出可直接复制的安装命令，因此这一节只写核实到的配置前提，命令与目录请以 SkillHub 页面为准。

需要 API key，页面标签为 requires_api_key=true。

部署前提有两条，来自官方介绍：

1、按 agent 自行部署 OpenD。
2、配置真实的牛牛号和真实的 acc_id。

这里强调「真实」是原文措辞，意思是不要拿模拟账号跑通就算完，自建 MCP 用于真实交易时要把账号与账户 ID 配准。

启用方式不是命令行调用，而是把 Skill 交给 Agent，用自然语言触发：

用 futu-mcp-guide Skill 帮我实现 futu-mcp-server

然后由 Agent 自己部署 OpenD，配置真实牛牛号和真实 acc_id。

Cursor / Codex CLI / Claude Code 的安装差异，官方资料里没有分别说明，这里不写。

典型用法¶

官方资料给出的可复现路径只有上面那条触发语，具体代码没有在页面中展开。按介绍，执行后的流程是：

1、Agent 载入 futu-mcp-guide，理解自建富途 MCP 的步骤。
2、部署 OpenD，建立本地连接。
3、配置真实牛牛号与真实 acc_id，完成鉴权。
4、用 futu-api 实现并注册第一个 MCP 工具。

行情 / 交易代码、持仓查询、股票代码标准化这些场景，是 Skill 声明的触发范围，落地时仍要按各自的数据接口逐项验证。

适用场景与注意¶

适合有 Python 与 MCP 经验的开发者。没有这两个基础，拿到 Skill 也难以独立完成 OpenD 部署与工具注册。

几个要注意的点：

1、富途官方没有 MCP 服务，一切靠自己用 futu-api 实现，维护成本在你这边。
2、第三方实现存在投毒风险，真实交易不要直接引入，自己搭建。
3、长桥证券已不支持新开户，这是选择自建富途 MCP 的现实背景。
4、Skill 版本 1.0.0，来源 community，能力边界以 SkillHub 页面为准。
5、数据范围覆盖港股、美股、A 股，但具体接口的可用性需要自行验证。

结尾¶

futu-mcp-guide 的价值不在提供现成的富途 MCP，而在把自建路径上的连接与注册问题先解决掉，让你不必从零读文档。如果你正在做富途的行情或交易 Agent，可以从这里起步。

官方地址：https://api.skillhub.cn/user_b785198a/futu-mcp-guide