dvt

dvt-plugin

dvt の Claude Code プラグイン — dvt（データ可視化ツール）の薄型クライアントです。

dvt は、データ可視化に対する AI ネイティブなアプローチです。データチームは、ダッシュボードをバージョン管理された JSON 仕様として扱い、人間もエージェントも同じ方法で作成できる、仕様駆動のワークフローを通じてダッシュボードを設計、生成、デプロイします。このプラグインは、そのワークフローを Claude Code に導入します。これは薄型クライアントであり、データも計算処理も含みません。次の 2 つをバンドルしています。

• dvt ダッシュボード仕様作成スキル。エージェントが dvt ダッシュボード仕様の読み取り、作成、検証を行えるようにします。
• dvt エンドポイントを指定した MCP クライアント。エージェントが稼働中の 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 サーバーを登録し、ダッシュボードの一覧取得によって接続を検証します。接続後は、エージェントにダッシュボードの作成を依頼するだけです。

このプラグインはオフラインでも動作するように作成スキルをバンドルしていますが、接続したエンジンも、エンジンが対応する仕様バージョンに合った独自のコピーを 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-publisher GitHub App によってプッシュされるため、このリポジトリに直接コミットしても次回の公開時に上書きされます。同じ理由により、Issue とディスカッションも受け付けていません。変更を提案する場合は、dvt.dev からご連絡ください。セキュリティに関する報告は [email protected]（および dvt.dev/.well-known/security.txt）宛て、またはこのリポジトリの GitHub の非公開脆弱性報告機能からお送りください。

バンドルされた仕様作成スキルの正規ソースは getdvt/dvt（web/public/dvt-spec-authoring-skill.md とその references/ ディレクトリ）に 1 つだけあり、公開時にツリー内に生成されるため、公開版が正規ソースからずれることはありません。SKILL.md は作成方法を説明し、references/ には必要に応じて読み込まれる詳細（パネルの種類、レイアウトモード、テーマ、データソース、エクスポート、メール）が含まれています。

メンテナーの方は、バージョンとタグの手順について RELEASING.md をご覧ください。

ライセンス

Apache-2.0。dvt はオープンファネルの成果物であり、このプラグインも仕様および SDK と同じライセンスに従います。