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 仓库 或 社区目录。
