DeepSeek Harness Cloudflare MCP 插件

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:

  1. Web 界面操作:
    進入 設置 → Cloudflare MCP,點擊「開始授權」。瀏覽器會打開 Cloudflare 的同意頁面,迴環回調會自動完成。在設置頁面點擊「測試連接」可列出已發現的工具。

  2. Chat 中通過 Agent 工具操作:

    • 請求 Agent 運行 cloudflare_mcp_oauth_start,獲取瀏覽器跳轉鏈接。
    • 在瀏覽器中完成授權後,將回調返回的 code 粘貼到 cloudflare_mcp_oauth_finish 中。

注意事項

  • 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 倉庫 或 社區目錄。

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

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

小夜