- Home
- Plugins
- Dev & Plugin Tools
- dsh-devtools
dsh-devtools
lukema95/dsh-devtools
Connects GitHub, Figma, Vercel, DigitalOcean, Notion and Linear as MCP servers, then manages their tools, permissions and activity from one DSH panel.
Install
dsh plugin --profile web add github:lukema95/dsh-devtoolsREADME
DSH DevTools
中文 · English
开源项目,MIT License。非 GitHub、Figma、Vercel、DigitalOcean、Notion 或 Linear 的官方项目。当前为 0.x 早期版本,插件 API 和配置可能变化。
DeepSeek Harness 的开发者工具集成。把 GitHub、Figma、Vercel、DigitalOcean、 Notion 和 Linear 作为 MCP server 接入,然后在 DSH 的一个面板里统一管理工具、 权限和调用历史。

npm:@lukema/dsh-devtools
项目主页:github.com/lukema95/dsh-devtools
问题反馈:GitHub Issues
插件会在 DSH 侧边栏增加 DevTools 入口,并在主区域打开全局面板。面板包含 四个标签页和两个详情视图:
- 集成 — provider 卡片,展示连接状态、工具数量和连接/管理操作。也可以添加 自定义 streamable-HTTP MCP server。
- 集成详情 — 连接信息、能力、该 provider 的工具开关、权限策略和调用活动。
- 工具 — 所有已发现的 MCP 工具,按 provider 分组,支持搜索、启用/禁用、 大目录的推荐集,以及工具详情对话框。
- 工具详情 — 工具输入 schema、自动生成的参数表单,以及通过 Agent 相同执行 链路发起的真实测试调用。
- 权限 — 每个工具的
auto/ask/block策略、写入审批开关,以及三个 一键配置(只读、标准、无人值守)。 - 活动 — 最近 200 次 MCP 调用,包含状态、耗时、脱敏参数和结果摘要。
环境要求
- DSH Desktop 或 DSH CLI,使用默认的
web或desktopprofile; - DSH
>= 0.2.2-rc.1,profile 需要挂载@deepseek-ai/dsh-mcp-manager和本地 凭据提供方; - 从源码运行测试需要 Node
^22.19.0 || >=24.0.0; - 没有构建步骤,也没有运行时 npm 依赖。
安装
从 npm 安装(推荐)
dsh plugin --profile desktop add @lukema/dsh-devtools
使用 Web profile 时把 desktop 换成 web。安装后重启 DSH,在侧边栏打开
DevTools。
需要固定版本时:
dsh plugin --profile desktop add @lukema/dsh-devtools@0.1.0
从 GitHub 安装
dsh plugin --profile desktop add github:lukema95/dsh-devtools
通过 DSH 界面安装
- 打开 DSH 侧边栏的 Plugins。
- 选择 Add plugin,再选 Install a third-party plugin,填入本目录的绝对路径。
- 启用 bundle,然后在侧边栏打开 DevTools。
从源码安装(开发)
git clone https://github.com/lukema95/dsh-devtools.git
cd dsh-devtools
npm test
dsh plugin --profile desktop add link:$(pwd)
安装后重启 DSH。修改 host/ 或 client.js 后需要重新加载插件或重启 DSH。
没有构建步骤:index.js 和 client.js 就是运行时文件,Host 侧只引用 Node 内置
模块。
开发与测试
npm test
测试使用临时的 DSH_HOME,不会读写真实的 provider 配置或凭据。四个测试文件分别
覆盖 Host 生命周期、推荐工具选择、OAuth 刷新和客户端注册。
项目结构:
host/plugin.js Host 生命周期、provider、工具治理和 API
host/oauth.js OAuth 发现、动态注册、PKCE、回调和刷新
host/selection.js 推荐工具集和 usage 相关逻辑
host/presets.js 内置 provider 定义
host/state.js 本地状态校验和迁移
client.js DevTools UI
test/ Host、选择、OAuth 和客户端测试
连接 provider
每个 provider 使用其 MCP server 支持的身份验证方式:
| Provider | 方式 |
|---|---|
| GitHub | Personal access token(classic 或 fine-grained) |
| Figma | 官方远程 MCP + 浏览器 OAuth(临时兼容客户端) |
| Vercel、DigitalOcean、Notion、Linear | 浏览器 OAuth |
| 自定义 server | 可选 bearer token |
GitHub — Personal access token
打开 GitHub → Connect,粘贴
GitHub settings → Tokens 创建的 token。
对话框会列出推荐 scope(repo、read:org、read:user、user:email、
read:packages、write:packages、read:project、project、gist、
notifications)。Token 会存入 DSH 的凭据提供方,引用名为
DSH_DEVTOOLS_GITHUB,MCP 条目通过 ${credential:DSH_DEVTOOLS_GITHUB} 读取;
页面不会回读 token 明文。
GitHub 远程 MCP server 不支持动态客户端注册,因此本插件不执行 GitHub OAuth 流程。请使用 PAT,或在外部自行注册 GitHub App/OAuth App。
连接对话框会保持打开,直到 MCP server 真正连接成功。Token 有问题时,server 错误会直接显示在对话框内,可以替换 token 后重试,不需要先断开。
Figma — 官方远程 MCP(临时兼容客户端)
Figma 官方 MCP server 是 https://mcp.figma.com/mcp,但 Figma 目前只允许其
MCP catalog 中的客户端接入。在 DSH 被加入之前,本插件注册 OAuth 客户端时会
使用一个临时兼容身份。这样不需要 Figma 桌面应用或 Dev Mode 就能使用官方远程
server,但这是对 Figma 策略的变通方案,Figma 调整 allowlist 后可能失效。
- 选择 Figma → Sign in,在浏览器里确认 OAuth 授权页。
- 对话框会提示 Figma 可能显示不同的客户端名称;那就是临时兼容身份。
- 插件把 access token 存为 credential ref,把 refresh token、client secret 和
client registration 存进
dsh-devtools/figmagrant record。不会写入cordis.patch.yml。 - 普通计划可以读取。写入 Figma 可能需要 Full 席位。
- 推荐工具集默认只启用只读工具;需要写入时,在 工具 标签页开启写工具,或让 Agent 搜索并开启。
不需要 Figma 桌面应用、Dev Mode 或 desktop MCP server。
Vercel、DigitalOcean、Notion、Linear — 浏览器 OAuth
选择 provider,点击 Sign in with …。浏览器会打开 provider 的授权页;确认后,
DSH 通过 loopback 回调拿到 code,并把 access token 存入凭据提供方。MCP 条目通过
${credential:DSH_DEVTOOLS_<PROVIDER>} 读取,插件会在过期前自动刷新。Refresh
token 和动态注册的 OAuth client 保存在 credential GrantRecord 中,不会进入页面。
流程使用 OAuth 2.1 authorization code + PKCE + state;provider 支持时会使用动态
客户端注册。回调只监听 127.0.0.1(RFC 8252)。如果浏览器拦截了标签页,对话框
会提供授权链接供手动打开。
DigitalOcean、Linear 和 Vercel 也支持 API token,对话框提供 Use an access token instead 作为后备。Notion 只支持 OAuth。
自定义 server 通过 Add MCP server 添加:名称、http(s) endpoint 和可选的
token。它们的行为与内置 provider 一致,也可以随时移除。
工具上下文预算
像 Vercel 这样的 server 会发布 200+ 个工具。每次请求都发送所有 schema,成本可能 超过任务本身,因此插件不会整体启用大目录:
- 30 个或更少工具的 provider 会全部启用。
- 超过 30 个工具的 provider 首次会启用一套冷启动推荐集,最多 20 个只读 工具,按资源相关性选择(projects、deployments、logs、errors、domains、 environments 等)。在发现过程稳定前,这些工具保持隐藏,不会短暂地全部启用。
- Agent 实际调用过工具后,推荐集会按调用频率重建:调用至少三次的工具成为 基础集(包含写入工具),少量常用只读工具覆盖新任务,未使用的工具保持隐藏。 使用历史生成后没有固定数量;16k token 的安全上限会防止异常大的目录。推荐集会在 重连/重启或点击 Refresh recommended 时重算,不会在模型步骤中途改变。
- Provider 卡片显示
已启用 / 总数;工具 标签页显示已启用集合的近似 schema token 数。 - Refresh recommended 按当前使用情况重算;Enable all 会先确认并显示额外 token 成本;Disable all 会完全移除该 provider 的 schema。
- 在推荐/自定义模式下新发现的工具默认禁用,直到手动启用。
- 使用次数保存在插件本地状态中,不会离开本机。
禁用一个工具会从每个 Agent 的请求中移除它的 schema。权限 → Block 只拒绝调用, 不会移除 schema;如果目标是减少上下文,请使用 工具 → 禁用。
早期版本配置的 provider 会在首次发现工具目录时迁移到推荐集。
Agent 不限于推荐集。两个小型插件工具让它可以发现并按需启用隐藏工具,而不必注入 整个目录:
devtools_search_tools搜索所有已连接 provider 的工具(包括禁用工具),并报告 provider、风险、策略和启用状态。devtools_enable_tool按精确名称启用一个工具。工具会在下一个模型步骤可见,正常 权限策略仍然生效。每个 provider 最多由 Agent 启用 40 个工具;超过后必须由用户 在工具页审核。
这两个工具只消耗几百 token;替代方案(200 个 Vercel schema)会消耗数万 token。
治理如何生效
连接 server 暴露的每个 MCP 工具名都是 mcp__<provider>__<tool>。插件在运行时层
治理这些名称,而不只是在 UI 中限制:
- 禁用的工具会通过该 Agent 自己 context 上的
ctx.tools.restrict()从其工具集中 移除,因此 schema 也会离开请求。工具连接、断开或变化时会重新应用 mask。 ctx.tools.guard()仍会拒绝禁用工具和策略为block的工具调用。其他插件无法 覆盖 guard 的拒绝。tools/pre-executewaterfall 会为需要确认的ask策略返回审批请求,并提供中英文 提示。- 不带 Agent 的程序化调用(包括页面内测试器)会绕过 Agent 策略,方便调试 Agent 无权调用的工具。
tools/result写入活动日志;参数和错误文本在存储前会脱敏。
风险根据工具名称和描述推断。以读取动词(get、list、search 等)开头的名称
默认视为只读,除非同时包含破坏性动词(delete、destroy、drop 等)。所有判断
都可以在 权限 页覆盖。推断只是启发式规则,不是安全边界:允许写入前,请审核
server 发布的危险工具。
工具开关影响两层:启用的工具可见且可调用;禁用的工具会从每个 Agent 的请求中隐藏 (减少上下文),即使调用被派发也会被拒绝。策略变更在 Agent 的下一个步骤生效。
数据与隐私
- Provider 选择、工具开关、策略、使用次数和活动保存在
$DSH_HOME/devtools/state.json,以仅 owner 可读的权限原子写入。使用 集成 → Danger zone → Reset DevTools data 可以连同已存凭据一起清除。 - Token 保存在凭据提供方(
$DSH_HOME/.credentials.yaml),不会进入插件状态或 浏览器。断开连接会保留 token;Reset 会移除它们。 - OAuth refresh token、client secret 和 client registration 保存在
dsh-devtools/*GrantRecord 中,使用 DSH 官方推荐的modifyRecord()记录 路径;access token 和 PAT 使用 credential refs。 - 页面只与一个 owner-only 路由通信:
POST /api/dsh-devtools。DSH 的连接层会在 handler 执行前拒绝非 owner 对端。 - 活动最多保留 200 次调用,存储脱敏参数和截断后的结果。
卸载与清理
卸载 bundle 不会删除插件状态或凭据。这不是插件“偷懒”,而是当前 DSH 没有
独立的 per-plugin 卸载钩子:卸载、禁用、重载和重启都会走插件生命周期,插件无法
可靠区分“用户要卸载”与“只是临时禁用/重启”。如果在 dispose 里删除凭据,用户
每次禁用插件或重启 DSH 都会被登出。
因此插件把清理做成显式操作,而不是卸载副作用。真正的“卸载时自动清理”需要宿主 提供独立的卸载确认或 hook;在此之前,需要清除凭据时由用户主动 Reset。
如果只是升级或重装插件,不需要 Reset:保留 state 和凭据可以直接恢复。
如果要换机、交出设备或不再使用这些集成,请在卸载前使用
集成 → Danger zone → Reset DevTools data。它会断开所有 provider,移除
DSH_DEVTOOLS_* refs 和 dsh-devtools/* 凭据记录,在 provider 支持 RFC 7009
时撤销 OAuth token,并清空 state.json。
如果插件已经被移除,请先停止 DSH,再手动清理:
~/.dsh/devtools/state.json~/.dsh/.credentials.yaml中的DSH_DEVTOOLS_*条目- 同一文件中的
dsh-devtools/*grant 记录
同时请在 provider 后台撤销授权;只删除本地 token 无法撤销 provider 仍认为有效的 grant。
限制
- 每个 provider 只支持一个账号;多账号和多 workspace 连接尚未实现。
- GitHub 使用 PAT;GitHub OAuth 需要预先注册应用,未内置。
- Figma 通过临时兼容客户端使用官方远程 MCP server;Figma 可能随时调整 allowlist。 写入可能需要 Full 席位。
- 浏览器 OAuth 假设 DSH Host 的 loopback 接口可从浏览器访问。Host 运行在容器或 另一台机器时,需要自行部署回调。
- 仅支持 streamable HTTP transport;stdio MCP server 请通过 DSH Settings 配置, 而不是本页面。
- Provider 名称是保留的(
github、figma等)。在 DSH Settings 中用同名配置 server 会让对应集成因重名而注册失败。 - DSH Desktop 默认凭据提供方是 0600 的 YAML 文件;同一 OS 用户的进程(包括 Agent 工具进程)可以读取它,它不是 OS keychain 隔离边界。
- 风险推断基于名称/描述,尚未消费工具 annotations。
- 策略是每个工具的全局策略。按项目隔离、限时授权和角色 profile(前端/后端/ DevOps)尚未实现;权限页的三个 profile 是基于风险的。
- 面板打开时,连接状态每 2.5 秒轮询一次。
- 断开连接只关闭连接,并保留已存 OAuth session 或 PAT,方便快速重连。Reset DevTools data 会移除所有凭据,并在 provider 支持 RFC 7009 时撤销 OAuth token。
贡献
欢迎提交 issue 和 pull request。开始前请阅读
CONTRIBUTING.md;提交 PR 前请运行 npm test。
请不要在 issue、PR、截图或日志中提交 token、OAuth code、client secret 或完整 凭据文件。
安全
安全问题请通过仓库的 GitHub Security Advisories 私下报告,不要开公开 issue。详见 SECURITY.md。
Figma 集成当前使用临时兼容身份绕过 Figma 的 MCP 客户端 allowlist。这是策略变通, 不是 Figma 官方集成;启用前请自行确认 Figma 条款和账号风险。
许可证
MIT © 2026 lukema95 and DSH DevTools contributors。
免责声明
本项目与 GitHub、Figma、Vercel、DigitalOcean、Notion、Linear 均无隶属或官方 关联。第三方名称和商标归各自所有者所有。
第三方 MCP server 的能力、权限和可用性由其提供方决定。尤其是 Figma 临时兼容 客户端、写入操作和 OAuth 策略可能随时变化,使用前请自行评估风险。
Related plugins
deepseek-harness
deepseek-ai/deepseek-harness
dsh-market
dsh-market/dsh-market
dsh-web (dsh-plugin-manager)
zhu1090093659/dsh-web
dsh-web
zhu1090093659/dsh-web