关于 dvt
dvt 插件将仪表板规范编写工作流带入 Claude Code,适合通过规范创建和审查数据可视化的团队与 Agent。它通过 MCP 连接 dvt 实例,支持离线使用内置编写技能。
主要功能
- 01编写和校验仪表板 JSON 规范
- 02连接 dvt 实例设计与渲染仪表板
- 03将规范应用到在线实例
- 04审查规范与仪表板布局
- 05按引擎版本加载编写技能
适用场景
- 01在 Claude Code 中制作仪表板规范
- 02向 dvt 实例提交并渲染仪表板
- 03检查仪表板的布局和分析叙事
- 04引擎更新规范后获取匹配技能
MCP 相关
插件作为 MCP 客户端连接托管的 dvt Gallery 或直接指定的引擎 URL,以设计、校验、渲染和应用规范。连接后可读取引擎提供的 dvt://skill/spec-authoring 资源;不可用时使用内置技能。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.dvt.dev/mcpclaude mcp add --transport http dev-dvt-dvt https://mcp.dvt.dev/mcp{"mcpServers":{"dev-dvt-dvt":{"type":"http","url":"https://mcp.dvt.dev/mcp"}}}在 Cursor 中打开{"servers":{"dev-dvt-dvt":{"type":"http","url":"https://mcp.dvt.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"dev-dvt-dvt":{"type":"http","url":"https://mcp.dvt.dev/mcp"}}}{"mcpServers":{"dev-dvt-dvt":{"serverUrl":"https://mcp.dvt.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.dvt.dev/mcp需要授权工具
详细介绍
dvt-plugin
dvt Claude Code 插件——dvt(数据可视化工具)的轻量客户端。
dvt 是一种 AI 原生的数据可视化方式:数据团队通过规范驱动的工作流设计、生成和部署仪表板,在这种工作流中,仪表板是经过版本管理的 JSON 规范,由人类和 Agent 以相同方式编写。此插件将该工作流引入 Claude Code。它是一个轻量客户端——不携带数据,也不进行计算。它包含两部分:
- dvt 仪表板规范编写技能,让 Agent 知道如何读取、编写和验证 dvt 仪表板规范;以及
- 指向 dvt 端点的 MCP 客户端,让 Agent 能够针对正在运行的 dvt 实例设计、验证、渲染和应用规范。
此插件是开源的,不设访问门槛。它不包含任何密钥或授权逻辑——你的访问权限完全由所连接的 dvt 端点和密钥决定。
安装
在任意 Claude Code 会话中:
/plugin marketplace add getdvt/dvt-plugin
/plugin install dvt@dvt-plugin
然后重启 Claude Code(插件不会热加载)。
连接
安装后,运行 /dvt:connect 并按照提示操作。插件通过 MCP 与 dvt 端点通信;可连接到以下两种目标之一:
- dvt Gallery(托管) — 使用 Gallery API 密钥连接到
https://mcp.dvt.dev/mcp。在你的 dvt 工作区中通过https://app.dvt.dev/app/api-keys创建密钥,然后在/dvt:connect提示输入时粘贴dvt_live_…值。Claude Code 会将密钥存储在用户范围内,不会提交到此处。 - 直接引擎 URL — 将客户端指向你已有的 dvt 引擎 URL(例如
http://localhost:8001/mcp)。
/dvt:connect 会在用户范围内注册一个使用你的端点和(对于 Gallery)密钥的 dvt MCP 服务,然后通过列出你的仪表板来验证连接。连接后,只需让 Agent 构建仪表板即可。
此插件捆绑了编写技能,因此离线也能使用;但已连接的引擎也会提供自己的副本——该副本与引擎所支持的规范版本匹配——作为 MCP 资源 dvt://skill/spec-authoring。当该版本不低于捆绑版本时,/dvt:connect 会优先在当前会话中使用它(并告知你),这样随着架构演进,编写过程仍能保持正确,无需重新安装。如果引擎未提供该资源,捆绑副本始终是有效的备用方案(ADR-0047)。
此插件绝不会嵌入密钥或进行任何授权检查。你能执行的操作由你的 dvt 端点和所提供密钥的作用域决定。
内容
.claude-plugin/
marketplace.json single-plugin marketplace so /plugin marketplace add resolves this repo
plugins/dvt/
.claude-plugin/plugin.json plugin manifest (name "dvt", semver)
commands/connect.md /dvt:connect — first-run setup + verify (registers the MCP server)
commands/dvt-review.md /dvt:dvt-review — critique a spec or a built dashboard, GO / REVISE
agents/dvt-layout-critic.md layout, visual design, readability — PASS / NEEDS ATTENTION / SIGNIFICANT ISSUES
agents/dvt-narrative-critic.md analytical story coherence — COHERENT / PARTIALLY COHERENT / INCOHERENT
skills/dvt-spec-author/ dvt dashboard-spec authoring skill (generated at publish time)
icon.svg
README.md
SETUP.md connecting from Cowork (GUI-only environments)
.github/workflows/
plugin-release.yml tags each published version v<semver>
RELEASING.md version + tag convention (semver in plugin.json)
LICENSE Apache-2.0
此仓库仅用于发布——请勿在此提交拉取请求。 上述所有文件均由私有
getdvt/dvt仓库中的plugins/**生成,并由dvt-publisherGitHub App 推送,因此直接提交到此仓库的内容会在下一次发布时被覆盖。基于相同原因,问题和讨论功能已关闭。如需提出更改建议,请通过 dvt.dev 联系我们。安全问题请发送至[email protected](也可查看dvt.dev/.well-known/security.txt),或通过此仓库的 GitHub 私密漏洞报告功能提交。
捆绑的规范编写技能在 getdvt/dvt 中只有一个规范源
(web/public/dvt-spec-authoring-skill.md 及其 references/ 目录),并在发布时生成到此目录树中,因此发布的副本不会与其发生偏差。SKILL.md 是编写方法;references/ 存放按需加载的详细内容(面板类型、布局模式、主题、数据源、导出和电子邮件)。
维护者:版本和标签流程请参阅 RELEASING.md。
许可证
Apache-2.0。dvt 是一个开放漏斗制品——此插件遵循规范和 SDK 的许可条款。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。