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