DeepSeek Harness 插件:dsh-qixin-insight-mcp-oauth

在 DeepSeek Harness(DSH)的插件生態中,接入企業級數據源(如啓信慧眼)通常涉及繁瑣的 API Key 配置或服務地址設置。dsh-qixin-insight-mcp-oauth 插件通過 OAuth 2.1 (PKCE) 標準授權流程,將啓信慧眼的 MCP 服務端掛載進 Harness,讓模型能夠直接查詢企業工商、股權、司法與風險等智能數據。

核心定位

這是一個 DeepSeek Harness 插件,由 qixin-ai-data 維護,分類爲“聯網工具”。它解決了傳統 MCP 接入需要手動配置 API Key 和服務地址的問題,通過瀏覽器端的一鍵授權,將啓信慧眼的工具掛載進對話。

安裝與啓用

插件已發佈在 npm,安裝命令如下:

dsh plugin --profile web add dsh-qixin-insight-mcp-oauth

安裝完成後,需要重啓 dsh 進程才能生效。

典型用法

插件通過對話工具進行操作,主要有三個命令:

  1. 連接服務
    對話中輸入“連接啓信慧眼mcp”。
    觸發工具 qixin_insight_mcp_connect:插件會發起授權,打開瀏覽器讓用戶登錄,完成後自動掛載 MCP 工具。如果已有有效授權,會直接複用。
  2. 查看狀態
    對話中輸入“啓信慧眼mcp連上了嗎”。
    觸發工具 qixin_insight_mcp_status:返回連接狀態、受衆綁定、Token 過期時間以及已掛載的工具前綴。
  3. 斷開服務
    對話中輸入“斷開啓信慧眼mcp”。
    觸發工具 qixin_insight_mcp_disconnect:執行 RFC 7009 吊銷 refresh_token,卸載工具並刪除本地憑證。

技術細節與注意事項

憑證管理

  • 無需配置文件存儲:插件不將 API Key 或 Token 寫入 cordis.yml 等配置文件。
  • 存儲位置:憑證存儲於 DSH 憑證服務(ctx.credentials),保證了跨進程寫入的安全性和互斥性。
  • 自動刷新:Token 過期前會自動刷新,重啓宿主後自動恢復連接。
  • 吊銷支持:斷開時支持 RFC 7009 吊銷 refresh_token。

環境要求

  • Node.js 版本:要求 ^22.19.0 || >=24.0.0。

已知限制

  • 無 UI 設置頁:僅通過對話工具操作,沒有圖形化的設置頁面。
  • 卸載清理:卸載插件後,必須先執行斷開命令(qixin_insight_mcp_disconnect),否則 DSH 憑證服務中仍會保留 grant 記錄,refresh_token 依然有效。
  • 工具抖動:Token 過期輪換時,會有一次 tools/list 往返的短暫工具抖動。
  • 單端點限制:一個插件條目對應一個 MCP 端點。

總結

該插件利用 OAuth 2.1 和 PKCE 標準簡化了企業數據源的接入流程,將憑證管理交由 DSH 憑證服務統一處理,適合需要在 DSH 環境中安全、便捷地調用啓信慧眼數據的場景。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜