DeepSeek Harness (DSH) 采用插件化架构。然而,DSH 内置的 @deepseek-ai/dsh-mcp-client 仅支持静态请求头,无法完成 mcp.vercel.com 所需的复杂 OAuth 2.0 认证(包含 WWW-Authenticate: Bearer)。要直接与 Vercel 平台交互,需要一个能实现官方 OAuth 2.0 客户端流程的解决方案。
这是什么¶
dsh-vercel-mcp 是一个为 DeepSeek Harness (DSH) 提供官方 Vercel MCP 连接的插件。它实现了 OAuth 2.0 流程(动态客户端注册 + PKCE S256),并作为代理会话中的 mcp__vercel__* 工具暴露 Vercel API 功能(部署、项目、域名、环境变量、DNS 记录等)。它还包含一个 Web 设置面板用于授权管理。
核心功能¶
- 官方 OAuth 2.0 认证:支持动态客户端注册与 PKCE S256 校验。
- Web 设置面板:提供可视化的授权入口,支持测试连接。
- Vercel API 工具:部署、项目管理、域名、环境变量、DNS 记录等操作。
- 自动 Token 刷新:在遇到 401 错误时自动刷新访问令牌。
- Agent 辅助工具:提供状态查询、OAuth 流程控制(开始/结束)、测试与清除凭证的辅助命令。
安装与启用¶
通过本地链接方式安装:
dsh plugin --profile web add link:/path/to/dsh-vercel-mcp
安装后,必须重启 DSH 主机以应用补丁并完成插件层的组合。
典型用法¶
通过 Web 设置面板授权:
1. 打开 DeepSeek Harness 的 Web 界面。
2. 导航至 设置 > Vercel MCP。
3. 点击 开始授权。浏览器将打开 Vercel 同意页面,回调将自动完成。
4. 点击 测试连接 以验证已发现工具。
通过 Agent 命令授权:
1. 在聊天中,请求代理运行 vercel_mcp_oauth_start。
2. 复制返回的 authorizeUrl 并在浏览器中打开。
3. 完成授权后,将回调中的 code 粘贴回 vercel_mcp_oauth_finish。
适用场景与注意¶
此插件解决了 DSH 内置客户端不支持 OAuth 的问题,让 DSH 代理能够直接操作 Vercel 资源。
注意事项:
* Token 存储在 ~/.dsh/dsh-vercel-mcp.json,文件权限为 0600。
* 所有 API 路由均为本地回环 (127.0.0.1),除了 OAuth 回调。
* 安装后需要重启 DSH 主机以应用补丁。
* 可用的工具映射为 mcp__vercel__*。
结语¶
通过此插件,DSH 代理现在可以直接与 Vercel API 交互。源码位于:GitHub