dashboardbase

dashboardbase MCP

ダッシュボードの JSON が正しいか、もう推測する必要はありません。尋ねてみましょう。

これは、dashboardbase の公式 MCP サーバーです。AI ツールに追加すると、アプリを開く前に、ウィジェットエンドポイントの応答やダッシュボード全体の設定ファイルを、dashboardbase が実際に適用する仕様に照らして検証できます。

dashboardbase skill は、エージェントに JSON の仕様を教えます。この MCP を使えば、エージェントが 自分の作業を検証できます。両方を使いましょう。skill で正しい形式に整え、MCP でそれを確かめます。

---

この MCP の機能

エージェントに 3 つのツールを提供します。

ツール	検証内容
validate_setup_file	dashboardbase の設定ファイル（ダッシュボード全体のウィジェットとデータソースを構成する JSON）を検証します。フィールド、行、列を示してエラーと警告を報告します。
validate_widget_response	ウィジェットの仕様に照らして、ウィジェットエンドポイントが返す JSON 本文を検証します。問題ごとにパスとメッセージを報告します。
create_setup_link	完成した設定ファイルをアップロードし、インポートプレビューを直接開くリンクを返します。リンクを求められた場合にのみ実行します。認証情報を含むファイルは拒否し、該当するフィールドを一覧表示します。

3 つとも dashboardbase の公開ツール API を呼び出します。アカウントも API キーも設定も不要です。

導入前 / 導入後

導入前 — エージェントがエンドポイントを書き、デプロイし、dashboardbase に接続すると、ウィジェットにエラーが表示されます。ドキュメントを読んで修正し、もう一度デプロイします。

導入後 — エージェントがエンドポイントを書き、応答を検証し、誤っていた 2 か所を修正して、最初から正しく表示できる状態で渡します。

Invalid setup file — 2 errors, 1 warning

  mappings[0].type  14:9  Unknown widget type "guage"
  mappings[1].path  22:5  Path must start with "/"

  warning  mappings[2]  No refreshInterval set

---

インストール

Claude Code

claude mcp add dashboardbase -- npx -y @dashboardbase/mcp

ワンクリック

Claude Desktop

最新リリースから dashboardbase-mcp.mcpb をダウンロードし、Claude Desktop の拡張機能設定にドラッグします。このバンドルは単体で動作するため、Node も必要ありません。

Cursor、Windsurf、その他多くのクライアント

これらは mcpServers 形式を使用します。~/.cursor/mcp.json（Cursor）、~/.codeium/windsurf/mcp_config.json（Windsurf）、またはお使いのクライアントに対応するファイルに追加してください。

{
  "mcpServers": {
    "dashboardbase": {
      "command": "npx",
      "args": ["-y", "@dashboardbase/mcp"]
    }
  }
}

VS Code

VS Code は例外です。mcpServers ではなく servers を使い、明示的な type が必要です。ワークスペースの .vscode/mcp.json またはユーザープロファイルに記述してください。

{
  "servers": {
    "dashboardbase": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@dashboardbase/mcp"]
    }
  }
}

Codex CLI

Codex は TOML を使用します。最も簡単なのは CLI です。

codex mcp add dashboardbase -- npx -y @dashboardbase/mcp

または、~/.codex/config.toml を手動で編集します。

[mcp_servers.dashboardbase]
command = "npx"
args = ["-y", "@dashboardbase/mcp"]

必要なのは Node.js 20 以降 だけです。これは唯一の前提条件であり、npx を使う場合にのみ必要です。ほかに設定するものはありません。検証 API は公開されているため、アカウント、キー、環境変数の設定は不要です。

常に最新の状態に保つ

異なる2つのものが、それぞれ異なる方法で届きます。覚えておくと便利です。

エラーメッセージの改善は自動で反映されます。 サーバーはスキーマを保持せず、ライブ API を呼び出すため、検証メッセージが改善されるとすぐに反映されます。更新は不要です。

新しいツールの利用にはパッケージの更新が必要です。 リリースでツールが追加された場合、パッケージを更新し、クライアントでサーバーを再起動すると利用できます。実行中のサーバーのツール一覧は、セッション中は固定されています。

インストール方法	更新方法
npx（Claude Code、Cursor、VS Code、Windsurf、Codex）	自動です。クライアントを再起動すると、次回のサーバー起動時に最新バージョンが使われます。
Claude Desktop .mcpb	インストール時のバージョンに固定されます。リリースから新しいバンドルをダウンロードし、再度ドラッグしてインストールしてください。
Docker	docker pull を実行するか、イメージを再ビルドしてください。

現在実行中のバージョンを確認します。

npx -y @dashboardbase/mcp --version

最新リリースより古いバージョンが表示された場合、npm がレジストリのメタデータをキャッシュしています。公開されたばかりのバージョンが表示されるまで、数分かかることがあります。強制的に更新するには、次を実行してください。

npx -y @dashboardbase/mcp@latest --version

リリースは semver に従います。新しいツールはマイナーバージョンの更新で追加され、既存の呼び出しが壊れることはないため、通常は安全に更新できます。

---

使い方

まず、接続されていることを確認する

claude mcp list

dashboardbase が接続済みとして表示されます。Claude Code のセッションでは、/mcp を実行するとサーバーと3つのツールが表示されます。ほかのクライアントでは、MCP パネルまたはツールパネルに dashboardbase があるか確認してください。

表示されない場合、サーバーは起動していません。node --version が20以降であること、設定ファイルに有効な JSON が記述されていることを確認してください。

あとは依頼するだけです

これらのツールを自分で呼び出す必要はありません。 実現したいことを説明すると、エージェントがファイルを読み込むときと同じように、ツールを呼び出すかどうかを判断します。特別な構文も、覚えておくこともありません。

手元にあるものを検証する場合：

• 「dashboardbase の設定ファイルを検証して」
• 「.dashboardbase/revenue.json は有効？」
• 「これを dashboardbase のコントラクトに照らして確認して」 — 続けて JSON を貼り付けます

作成の一環として検証する場合：

• 「MRR の KPI エンドポイントを作成して、返されるレスポンスを検証して」
• 「設定ファイルにゲージウィジェットを追加して、引き続き検証に通ることを確認して」

問題をデバッグする場合：

• 「dashboardbase でゲージウィジェットにエラーが表示されます。エンドポイントの戻り値をコントラクトに照らして確認して」
• 「dashboardbase が設定ファイルを拒否するのはなぜ？」

表示例

あなた： 収益ウィジェットが表示されません。.dashboardbase/revenue.json を確認してください。

エージェント： validate_setup_file を呼び出します

無効な設定ファイル — エラー2件

  mappings[0].type  14:9  不明なウィジェットタイプ "guage"
  mappings[1].path  22:5  パスは "/" で始まる必要があります

エージェント： 2つ問題があります。guage は gauge のタイプミスで、2つ目のマッピングでは パスの先頭のスラッシュが欠けています。両方修正します。

ファイルを編集し、再度 validate_setup_file を呼び出します

有効な設定ファイル — エラーはありません。

検証、修正、再検証という一連の流れが、このツールの目的です。dashboardbase を開かなくても、エージェントが最後まで完了させます。

または、直接呼び出す

Claude Code では、サーバーがスラッシュコマンドを追加します。/ と入力すると、メニューに表示されます：

/mcp__dashboardbase__validate .dashboardbase/revenue.json

パスを省略すると、現在作業しているファイル、または次に貼り付ける内容が検証されます。これは決定論的な方法です。エージェントがそのツールを関連性のあるものと判断するかどうかに左右されません。

中央のセグメントは、インストール時に指定した名前に基づきます。claude mcp add dashboardbase … を実行した場合は /mcp__dashboardbase__validate になります。別の名前でインストールすると、そのセグメントも名前に合わせて変わります。

MCP プロンプトに対応していないクライアントでは、ツール名を平易な言葉で指定してください：

• 「.dashboardbase/revenue.json で validate_setup_file を使ってください」
• 「これを確認するために validate_widget_response を使ってください」

エージェントは最初に促す必要がある場合もありますが、その後は通常、自分で使うようになります。

3 つのツール

ツール	引数	備考
validate_setup_file	content — ファイルのテキスト path — 代わりにディスクから読み込み	どちらか一方を指定してください。
validate_widget_response	response — エンドポイントの JSON 本文 path — 代わりにディスクから読み込み widgetType — 任意。例：kpi	widgetType を省略すると、レスポンスから推定されます。
create_setup_link	content — ファイルのテキスト path — 代わりにディスクから読み込み	リンクの有効期限は 48 時間です。リンクを持っている人は誰でもファイルを読めるため、直接共有してください。

知っておくとよい点が 2 つあります：

• path は stdio でのみ使用できます。 ホスト型の HTTP デプロイメントからはディスクにアクセスできないため、このパラメーターは提供されません。代わりに content／response を渡してください。
• validate_widget_response にはレスポンス本文全体が必要です。エンドポイントが実際に返す title／actions／data／alert のエンベロープであり、内部の data ペイロードだけではありません。

設定

すべて任意です。

変数	デフォルト	目的
DASHBOARDBASE_API_URL	https://api.dashboardbase.com	別の環境を指定します。
DASHBOARDBASE_API_KEY	未設定	x-api-key として送信されます。パブリック API では不要です。
DASHBOARDBASE_TIMEOUT_MS	15000	リクエストのタイムアウト（ミリ秒）です。

HTTP サーバーとして実行する

コンテナーや、社内で共有するデプロイメントの場合：

npx @dashboardbase/mcp --http --port 3000
# or
docker build -t dashboardbase-mcp . && docker run -p 3000:3000 dashboardbase-mcp

/mcp で Streamable HTTP を、/health でヘルスチェックを提供します。完全にステートレスなため、セッションアフィニティなしで水平スケーリングできます。ブラウザーのオリジンは、--allowed-origin https://example.com で許可リストに追加しない限り拒否されます。このモードでは、ファイル読み込み用の path パラメーターは公開されません。

---

リポジトリの内容

mcp/
├── src/
│   ├── index.ts            # CLI entry — stdio by default, --http optional
│   ├── server.ts           # Registers the three tools
│   ├── api.ts              # Client for the dashboardbase Tools API
│   ├── format.ts           # Renders results as readable text
│   ├── http.ts             # Stateless Streamable HTTP handler
│   └── tools/              # One file per tool
├── test/                   # Unit tests, no network required
├── tools.json              # OpenAPI spec for the validation API
├── server.json             # MCP Registry manifest
├── manifest.json           # Claude Desktop bundle manifest
└── Dockerfile

検証の仕組み

サーバーはスキーマのコピーを保持せず、稼働中の dashboardbase 検証 API を呼び出します。そのため、プラットフォームが受け付ける内容とのずれが生じません。また、API の改善に伴ってエラーメッセージも改善されるため、利用者側でアップグレードする必要はありません。

これは検証ルールとメッセージに当てはまるもので、サーバー自体には当てはまりません。ツールを追加するリリースでは、引き続きパッケージの更新が必要です。最新の状態を保つをご覧ください。

関連情報

• dashboardbase — 製品です。API からダッシュボードを作成、ホスト、共有できます。
• dashboardbase skill — 無料でインストールできます。エージェントに JSON コントラクトを教え、最初から正しいエンドポイントを書けるようにします。この MCP と直接連携します。
• ドキュメント — ウィジェットリファレンス、JSON コントラクト、Webhook の設定。

コントリビューション

不足している点や分かりにくいエラーを見つけた場合は、Issue を作成してください。検証ルール自体は dashboardbase のバックエンドにある点にご注意ください。メッセージが分かりにくい場合も、こちらに報告する価値があります。上流で修正します。

ライセンス

MIT — LICENSE をご覧ください。フォーク、改変、配布は自由です。

MIT ライセンスの対象はこのリポジトリ内のコードであり、dashboardbase の名称やロゴは含まれません。これらは Kompile ApS に帰属します。サーバーは自由に使用・改変できますが、公式な関係があると誤解されるような形で名称やブランドを使用しないでください。

dashboardbase skill には別のライセンスが適用されます。インストールと使用は無料ですが、オープンソースではありません。