前言¶

富途有官方 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