DeepSeek Harness (DSH) 支持通過插件擴展功能。在構建涉及金融數據查詢或交易的智能體時，對接富途 OpenAPI 是常見需求。本文介紹 @yangzhe1991/dsh-futu-mcp 插件，它通過標準協議將富途 MCP 服務器的工具暴露給智能體，並處理底層的安全認證流程。
插件說明¶
該插件作爲 DSH 的組件，負責建立與富途官方 MCP 服務器（https://mcp.futunn.com/mcp）的連接，並將服務器提供的工具註冊爲 mcp__futu__<toolName>。
核心功能¶
- 連接與註冊：使用支持分頁的 MCP 可流式 HTTP 傳輸協議連接富途服務器，將工具註冊到智能體的工具上下文中。
- OAuth 2.1 認證：完全在進程內處理 OAuth 2.1 授權，支持 RFC 9728 / RFC 8414 發現、動態客戶端註冊（RFC 7591）、PKCE S256 以及刷新令牌輪換。
- 權限管控：嚴格限制授權範圍，默認僅開放
quote:read（行情只讀）和trade:read（交易只讀）。插件會攔截服務器的元數據，確保客戶端註冊和授權請求不會申請超出配置的權限。 - 延遲授權：插件加載時僅註冊工具列表，不產生任何網絡流量。只有在智能體實際調用富途工具時，纔會建立連接、刷新令牌或觸發瀏覽器登錄。
- 安全存儲：令牌存儲在工作區目錄之外，默認路徑爲
~/.dsh/credentials/futu-mcp，文件權限爲0600，保證安全性。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add @yangzhe1991/dsh-futu-mcp
安裝完成後，請重啓 dsh web。
配置與使用¶
在對話中直接使用工具名稱。例如，詢問“查一下騰訊的實時股價”即可觸發連接驗證。
若需進行交易操作，需在配置文件中調整授權範圍。默認配置爲只讀：
scopes: [quote:read, trade:read]
如需下單或撤單，需將範圍修改爲：
scopes: [quote:write, trade:write]
注意事項¶
- Token 有效期：訪問令牌有效期約 2 小時，刷新令牌有效期最長 14 天。
- 登錄觸發時機：瀏覽器登錄頁面僅在刷新令牌過期或被撤銷（超過 14 天）且調用工具時纔會彈出。
- 零流量設計：插件加載時不會彈出任何網絡或瀏覽器提示，只有在工具被實際調用時纔會進行交互。
- 令牌管理：可在富途 OpenAPI 儀表盤中隨時撤銷令牌。
