DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。Cloudflare 提供的 MCP 服務要求 OAuth 2.0 認證,而 DSH 內置的客戶端僅支持靜態 Header,無法完成完整的 OAuth 流程。dsh-cloudflare-mcp 插件基於官方 @modelcontextprotocol/sdk 實現,補全了動態客戶端註冊、PKCE S256 校驗和迴環回調等邏輯,使 Agent 能夠通過 DSH 真正連接並操作 Cloudflare 資源。
核心功能¶
該插件將官方的 mcp.cloudflare.com 接入 DSH,並提供了完整的認證與工具管理能力:
- 完整 OAuth 2.0 流程:支持動態客戶端註冊、PKCE S256 和迴環回調。
- Web 設置面板:提供圖形化界面管理授權。
- Cloudflare API 工具:授權後,Agent 可通過
mcp__cloudflare__*前綴調用 Cloudflare 的各類 API,包括 Accounts、Workers、Pages、DNS、R2、KV、D1 和 AI。 - Agent 輔助工具:提供狀態檢查、OAuth 流程啓動、代碼粘貼完成、連接測試和憑據清理等工具。
- 自動 Token 刷新:當 API 返回 401 時,插件會自動刷新訪問令牌。
安裝與啓用¶
安裝插件需要通過本地鏈接方式添加。安裝完成後,必須重啓 Host 才能使插件層生效。
dsh plugin --profile web add link:/path/to/dsh-cloudflare-mcp
典型用法¶
授權和連接主要通過兩種方式完成,流程均指向 mcp.cloudflare.com:
-
Web 界面操作:
進入 設置 → Cloudflare MCP,點擊「開始授權」。瀏覽器會打開 Cloudflare 的同意頁面,迴環回調會自動完成。在設置頁面點擊「測試連接」可列出已發現的工具。 -
Chat 中通過 Agent 工具操作:
- 請求 Agent 運行
cloudflare_mcp_oauth_start,獲取瀏覽器跳轉鏈接。 - 在瀏覽器中完成授權後,將回調返回的
code粘貼到cloudflare_mcp_oauth_finish中。
- 請求 Agent 運行
注意事項¶
- Token 存儲:訪問令牌存儲在
~/.dsh/dsh-cloudflare-mcp(權限 0600),請勿手動修改。 - 網絡限制:除 OAuth 回調接口外,API 路由僅監聽
127.0.0.1(迴環地址)。 - 依賴版本:插件依賴
@deepseek-ai/cordis及相關 DSH 客戶端運行時,需確保環境版本兼容。 - 許可證:採用 MIT 許可證。
總結¶
zhengjy01/dsh-cloudflare-mcp 解決了 DSH 原生客戶端無法處理 OAuth 認證的問題,爲開發者提供了一個無需手動管理 Token 即可調用 Cloudflare 全系列 API 的方案。更多細節可參考 GitHub 倉庫 或 社區目錄。