dsh-vercel
Verified@adenxie/dsh-vercel · v0.4.0 · MIT · Web UI
DeepSeek Harness Vercel MCP connection with OAuth, a settings panel, and on-demand official Vercel skills
Install
dsh plugin add @adenxie/dsh-vercel Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-vercel
在 DeepSeek Harness 中使用 Vercel 项目、部署与平台工具。
通过 OAuth 连接官方 MCP 服务,按需读取 Vercel 技能指导。
English · 简体中文
@adenxie/dsh-vercel 把 Vercel 官方 MCP 服务接入 DeepSeek Harness。登录一次 Vercel 后,模型就能查询项目、部署和团队等信息,也能按需读取随包附带的 34 个 Vercel 技能文档。当前版本是 0.4.0。
安装
需要 DeepSeek Harness 0.2.1-rc.2 至 0.2.x,Node.js ^22.19.0 || >=24.0.0。Desktop 和 Web 使用不同的 profile,安装时选你实际运行插件的那个。
从 npm 安装
先打开一次 DSH Desktop 让它初始化 profile,然后完全退出,再用 Desktop 自带的 CLI 安装:
$DshCli = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
& $DshCli plugin --profile desktop add '@adenxie/[email protected]'
装完重新打开 Desktop。Web profile 用 dsh plugin --profile web add @adenxie/[email protected]。
从安装包安装
从 0.4.0 Release 下载 adenxie-dsh-vercel-0.4.0.tgz,或者在源码目录运行 npm pack 自己生成。同样先初始化并退出 Desktop,然后在安装包所在目录运行:
$DshCli = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
$Archive = (Resolve-Path './adenxie-dsh-vercel-0.4.0.tgz').Path
& $DshCli plugin --profile desktop add $Archive
其他平台用 dsh plugin --profile web add /path/to/adenxie-dsh-vercel-0.4.0.tgz,路径和 profile 换成你自己的。
从源码安装
适合开发调试,日常使用建议装 npm 包或安装包。
git clone https://github.com/AdenXie/dsh-vercel.git
Set-Location dsh-vercel
pnpm install --frozen-lockfile
pnpm run build
$DshCli = Join-Path $env:LOCALAPPDATA 'Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd'
$Checkout = (Get-Location).Path
& $DshCli plugin --profile desktop add "link:$Checkout"
其他平台用 dsh plugin --profile web add link:/path/to/dsh-vercel,然后重启对应的 Host。上面的示例都通过 $env:LOCALAPPDATA 找到 Desktop 自带的 CLI,所以系统 PATH 里不需要有 dsh。
连接 Vercel
第一次使用时运行 adenxie_vercel_mcp_account(action=login),在浏览器里登录并授权。连接成功后,Vercel 的 MCP 工具会以 mcp__adenxie_vercel__* 的名字出现。同一个工具的 status、test、clear 可以查看状态、测试连接或清除凭据,设置页也能做这些操作并刷新令牌。
授权会申请 openid offline_access,这样 Vercel 才会发刷新令牌。如果你是从旧版升级、旧授权里没有刷新令牌,在设置页重新授权一次即可;新授权成功之前,原来的凭据会一直保留。
手动完成授权时,用 action=finish 并提供完整的回调 URL(包含 code 和 state),或者同时传入这两个值。只传 code 会被拒绝,因为插件要校验 state。
按需加载工具
Vercel 服务端有两百多个工具,全部塞给模型会占掉大量上下文。所以每个 Agent 一开始只看到 8 个辅助工具:先用 adenxie_vercel_mcp_search_tools 搜索,再把名字交给 adenxie_vercel_mcp_load_tools,对应的 Vercel 工具在下一轮出现在这个 Agent 里。已经知道 Vercel 原始工具名(如 list_projects)时可以直接加载,不用先搜索。
- 每个 Agent 最多同时加载 6 个工具,schema 合计不超过 32000 字符。
- 在
deepseek-flash上实测,会话中途加载的工具以延迟声明的方式下发,模型有时不认为它们可调用,直到上下文压缩之后才直接调用。这时可以用adenxie_vercel_mcp_call传入name和arguments调用已加载的工具。它在 DSH 内部按真实工具名嵌套执行,审批、守卫和策略与直接调用完全一样,也调不到当前 Agent 没有加载的工具。 - 尽量不要卸载。DeepSeek 线路以
addition-only方式更新工具列表:新增工具会追加在对话历史后面,提示缓存不受影响;卸载或mode=replace会重写工具列表,之后的请求都无法命中缓存。只有预算不够时才用adenxie_vercel_mcp_unload_tools。 - 加载结果只对当前 Agent 生效。子 Agent 只能加载父 Agent 已经加载的工具,DSH 宿主本身的限制照常生效。
- 断线会清空已加载的工具,重连后重新搜索、加载即可。
精简后的 schema
声明给模型的 schema 是精简过的:去掉 $schema、title、example(s) 和布尔型 additionalProperties 这类不影响参数是否合法的标注,参数说明只保留第一层。属性名、类型、枚举、required 都原样保留,Vercel 服务端仍按完整 schema 校验每次调用。导出的工具目录也保持原样。
精简后仍超过 6000 字符的工具(目前 10 个,如 update_project、create_deployment),会把其中最大的几个属性折叠成只有类型和提示的占位,其余字段照常展开。模型需要折叠部分时,用 adenxie_vercel_mcp_describe_tool 按路径(如 requestBody.framework)查看完整结构,不用先加载。
按 237 个工具的快照计算,声明总量从约 48.6 万字符降到约 29.1 万字符(少 40%),最大的单个工具不超过 6000 字符,加载前的初始开销是 8 个工具共 2882 字符加 400 字符的系统提示(0.3.1 是 11 个工具 2974 字符加 871 字符)。这些都是序列化字符数,不是 token。
长结果分页
工具返回的内容超过 12000 字符时,结果会被截断,结构化结果里附带一个结果 handle。
- 普通文本:模型先看到前 12000 字符。用
adenxie_vercel_mcp_read_result传入resultId和上一页的nextOffset继续读,每页最多 12000 字符。 - JSON(部署列表、项目列表等):模型只看到前 4000 字符和一份结构概要,概要列出顶层字段、数组长度和数组条目里有哪些字段。之后可以只读需要的字段,例如
read_result({resultId, path: "deployments", fields: ["uid", "state", "url"], limit: 50}),这时offset/limit按条目计数,每次最多 200 条。不传path/fields时仍按字符续读。
缓存按 Agent 隔离,每个 Agent 最多保存 8 个结果、合计 100 万字符,超出时淘汰最旧的。Agent 销毁或 MCP 断线时缓存会清空。读不了的情况(结果太大没进缓存、handle 过期、handle 属于别的 Agent 等)工具会直接提示你缩小查询范围。
官方技能
包里带了 vercel/vercel-plugin 的 34 个技能,涵盖部署与 CI/CD、域名、环境变量、Functions、存储、AI SDK 等主题。模型通过 adenxie_vercel_skill 使用它们:不传 path 时列出技能(可用 query 筛选),传 path 时读取技能或引用文件。这些技能不会注册成 DSH 原生技能,什么时候去读由模型自己判断。
技能里有 CLI 命令、部署流程和自动化脚本片段,插件只负责提供内容,不会自动执行。系统提示也要求模型不要读取插件的凭据文件、不要绕过插件直连 Vercel,但这只是约束模型的提示:拥有本机文件和 shell 权限的 Agent 仍然读得到 ~/.dsh/adenxie-dsh-vercel.json,请用 DSH 的审批策略控制这类操作。按技能操作时,以实际可用的 mcp__adenxie_vercel__* 工具为准,涉及 CLI 时先核对本机 vercel --help。部署前先确认项目和目标环境,分清 preview 和 production。上游的 hooks、脚本运行器和 Codex 专用配置没有打包进来。
配置与接口
- 凭据保存在
~/.dsh/adenxie-dsh-vercel.json,权限 0600。可以用环境变量DSH_VERCEL_CONFIG指定其他路径。如果新文件不存在而旧版的~/.dsh/dsh-vercel.json存在,插件会把旧文件复制过来,旧文件本身不动。 - 插件的 Bundle row 和设置 ID 是
adenxie-dsh-vercel,设置 API 在/api/adenxie/dsh-vercel/下,本地 helper 统一用adenxie_vercel_*前缀,不会和其他 Vercel 插件冲突。 - 连接后可以从仅限本机访问的
GET /api/adenxie/dsh-vercel/catalog导出完整工具目录,包括远端名、DSH 映射名、输入输出 schema、annotations 和元数据。annotations 只是服务端给的提示,不做访问控制。 - MCP 返回的 structuredContent 和
_meta会保存在 DSH 的结构化结果里,_meta不会作为文本发给模型。
限制
- 可用的工具取决于你的 Vercel 账号、团队权限和服务端当前提供的工具列表。
- Vercel 的写入和部署操作还没有实际测试过。目前实测过的是授权、令牌刷新、断线重连和项目查询这类只读操作。
- 插件没有额外的写操作审批,也不会根据 annotations 自动批准或拒绝,审批沿用 DSH 宿主的策略。
- 图片、音频等多模态内容只保存在结构化结果里,模型看到的是占位文本;远端的 MCP App/widget 界面没有嵌入。
- 和 Codex 的 Vercel 插件相比,工具目录 237 个里有 234 个同名,但功能没有完全对齐。详见功能对比。
每项检查的具体做法和结果见验证记录,显式团队范围下 list_projects 的兼容处理见项目范围说明。
许可与来源
我是 AdenXie,负责这个项目的开发和维护。最初的 MCP 连接层来自 zhengjy01/dsh-vercel-mcp,我在它的基础上加了命名隔离、按需加载工具、长结果分页、元数据保留和若干兼容修复。原作者的 MIT 版权和许可声明保留在 LICENSE 中。
随包的 Vercel 技能来自 vercel/vercel-plugin 的 137e9f44a243a939c5eaea30e4dff96aee744f64 提交,按 Apache License 2.0 分发,许可文本和来源说明在 LICENSES/ 目录。
本地开发
pnpm install --frozen-lockfile
pnpm run typecheck
pnpm run build
pnpm test
npm pack --dry-run
测试使用本地 HTTP MCP 服务和临时凭据目录,跑完自动删除,不会碰你真实的凭据文件。在线授权、真实令牌刷新和 DSH 界面测试需要已授权的环境,要单独运行。