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 仪表盘中随时撤销令牌。
