Showboard

Showboard は、Claude Code、Codex、Cursor、Gemini CLI などのコーディングエージェントが、SQL データベースやExcel／CSV ファイルのフォルダーについて、グラフ、表、主要な数値を使って質問に答えられるようにする MCP サーバーです。ブラウザー、自分のアプリ内、またはターミナルの横で利用できます。

エージェントは、読み取り専用の SQL クエリをいくつかと、簡単なレイアウトを作成します。Showboard はクエリを実行し、各結果に適したグラフを選び、ダッシュボードを配置して画面に表示します。すべての数値はクエリから取得され、グラフの下からワンクリックで確認できます。

エージェントにセットアップを任せる

プロジェクト内で、コーディングエージェントに次のように依頼します。

このプロジェクトにShowboardをセットアップしてください。npx showboard guideを実行し、手順に従ってください。

ガイドはエージェント向けに書かれています。プロジェクトに適した方法（スプレッドシート、データベース、または独自のアプリ）をエージェントに選ばせ、コマンドを実行し、npx showboard doctorで自らの作業を確認させます。doctorは各エージェントが使用する方法でShowboardを起動し、問題があれば修正方法を案内します。

手動でセットアップする場合

Node.js 22.13 以降が必要です。

スプレッドシートのフォルダー、またはデータベースの場合：

npx showboard init ./reports                 # .xlsx, .xlsm, .csv, .tsv files or folders of them
npx showboard init --db ./shop.sqlite        # or a Postgres URL (or set SHOWBOARD_DB)
npx showboard doctor                         # checks the setup

そのフォルダーでエージェントを再起動し、http://localhost:4710 を開くか、エージェントの横にあるターミナルで npx showboard pane を実行します。initはClaude Codeの設定を書き込み、さらに、そのフォルダーにすでに設定があるエージェントの設定も書き込みます。ほかのエージェントを指定するには、--agent codex,opencode,bharatcode,gemini,cursor,vscode（または all）を渡します。

独自のアプリ内で使用する場合（React 19）：

npm install showboard zod

// server: mount the handler. Next.js, Express, Hono and node:http are in the guide.
import { createShowboard } from "showboard/server";

const showboard = await createShowboard({ db: process.env.DATABASE_URL, boardsDir: ".showboard/boards" });
const handle = showboard.handler({ basePath: "/showboard" });   // (req: Request) => Promise<Response>

// page: where boards appear
import { Board, ShowboardProvider } from "showboard/react";
import "showboard/styles.css";

<ShowboardProvider url="/showboard">
  <Board />
</ShowboardProvider>;

続いて、エージェントの接続先を指定します：npx showboard init --url http://localhost:3000/showboard。

コマンド

コマンド	内容
showboard guide	コーディングエージェント向けのセットアップ手順
showboard init	このフォルダー内の各エージェントの設定にShowboardを追加します
showboard doctor	各エージェントでの使用方法に沿ってセットアップを確認し、修正方法を提示します
showboard mcp	エージェントが起動するMCPサーバー
showboard serve	Showboard単独のダッシュボードページ
showboard pane	エージェントの横にあるターミナルに、ダッシュボードをテキストで表示します

安全性を重視した設計

• Postgresのクエリは、時間と行数に上限を設けた READ ONLY トランザクションで実行されます。SQLiteファイルは読み取り専用で開かれ、スプレッドシートは読み取りのみ行います。
• 受け付けるのは SELECT のみです。
• アプリ内では、エージェントが実行できるのは登録したアクションのみで、それぞれの入力はスキーマに照らして検証されます。
• ハンドラーは localhost からのリクエストにのみ応答し、ほかのウェブサイトからのリクエストは拒否します。

詳細

• README：ベンチマーク、仕組み、使用例。
• SETUP.md：エージェント向けのセットアップガイド。
• リファレンス：すべてのオプション、ツール、コマンド、ルート。

MITライセンスです。主にClaude CodeをはじめとするAIコーディングエージェントの支援を受けて開発されました。