Tabellum

Tabellum — MCP のセットアップ

AI アシスタントが、PostgreSQL、MySQL/MariaDB、SQL Server、BigQuery 用のデスクトップデータベースクライアントである Tabellum を通じてデータベースを操作できるようにします。MCP サーバーはお使いのマシンで 実行中のアプリによって ホストされます。このパッケージは、アプリにリクエストを転送する小さな stdio シムです。アシスタントが作成したクエリはエディターにリアルタイムで表示され、アプリで クリックしない限り、データを変更する操作は実行されません。

• サーバー： tabellum
• トランスポート： stdio（ローカルプロセス）
• パッケージ： @dudko.dev/tabellum-mcp — Node.js 24+
• 認証： インストールごとにアプリが生成するトークン。シムが ~/.tabellum/mcp.json から自動的に読み取ります。

できること

Tabellum アプリを開くと、アシスタントはアプリ内蔵のエージェントと同じツールを利用できます。アプリがツールを提供するため、一覧はアプリのバージョンに応じて変わります。読み取りはすぐに実行され、書き込みを伴う操作はすべてアプリでのクリックを待ちます。

ツール	機能
データベースの確認
list_connections	接続名、ドライバー、読み取り専用フラグを表示します。ホスト名やユーザー情報は表示しません。
describe_schema	接続内のすべてのスキーマについて、テーブル、ビュー、関数、プロシージャ、シーケンスの名前を表示します。
describe_object	1 つのオブジェクトのカラム、インデックス、制約、CREATE 文を表示します。
list_users	データベースに登録されているユーザーとロール、およびそれらのフラグを表示します。
sample_rows	テーブルの最大 N 行を表示します。ただし、接続で行データの共有が許可されている場合に限ります。
クエリ
run_read	エンジンが読み取りと判定した場合にのみステートメントを実行します。それ以外の場合は needs_approval を返します。
explain	読み取り操作の推定実行計画を表示します。実行はされません。
propose_write	書き込み、DDL、管理用のステートメントを アプリでの承認用に 提案します（タイムアウトは 10 分）。
open_editor_tab	接続に紐づいたクエリタブを開きます。
draft_to_editor	実行せずに、確認しながらタブに SQL を入力します。
スキーマの比較
compare_schemas	接続を別の接続または保存済みスナップショットと比較します。migration: true を指定すると、差分を埋めるステートメントも表示します。実行はされません。
save_schema_snapshot / list_schema_snapshots	接続のスキーマをワークスペースに保存し、スナップショットを一覧表示します。
ダッシュボード
list_dashboards / get_dashboard	ワークスペースのダッシュボード、および 1 つのダッシュボードのファイルとパネルを表示します。
propose_dashboard	新規または変更後のダッシュボードを提案します。差分を確認して適用できます。
スキーマ設計
list_designs / get_design	ワークスペースのスキーマ設計、および 1 つの設計のファイルとオブジェクトを表示します。
propose_design	新規または変更後の設計を提案します。追加、変更、削除される内容を確認できます。データベースに対して実行される操作はありません。
describe_feature	designer、dashboards、schema_compare のファイル形式とルールを表示します。提案を行う前に読み取られます。

リソースを利用するクライアント向けのリソース：tabellum://connections、 tabellum://schema/<connection>、tabellum://snapshots、 tabellum://dashboards、tabellum://designs。すべての呼び出しはアプリ内に記録されます。タブにはバッジが表示され、エージェントログには行が追加されます。

---

Claude Code にインストールする（プラグイン）

/plugin marketplace add dudko-dev/tabellum-mcp-setup
/plugin install tabellum@tabellum
/reload-plugins

先に Tabellum アプリを起動してください（macOS、Windows、Linux）。シムはアプリの実行中に書き込まれる ~/.tabellum/mcp.json から、アプリのローカルポートとトークンを読み取ります。アプリが閉じている間は、すべての呼び出しに「Tabellum is not running」と返されます。

マーケットプレイスを使わない場合は、サーバーを直接追加してください：

claude mcp add tabellum -- npx -y @dudko.dev/tabellum-mcp

---

その他のクライアントから接続する

Claude Desktop

claude_desktop_config.json（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json または .cursor/mcp.json：

{
  "mcpServers": {
    "tabellum": {
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

VS Code（GitHub Copilot / MCP）およびその他のクライアント

{
  "servers": {
    "tabellum": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dudko.dev/tabellum-mcp"
      ]
    }
  }
}

---

安全性

• エンジンが分類し、承認するのはユーザーです。 すべてのステートメントはアプリのパーサーによって分類されます。読み取りではない操作はすべて propose_write を経由し、ユーザーがクリックするまで保留されます。モデルがどのようなラベルを付けても、この分類が覆されることはありません。
• ループバックのみです。 アプリは 127.0.0.1 でリッスンし、インストールごとに異なるベアラートークンを使用します（Settings → Agents で確認および再生成できます）。
• 行データの共有は接続ごとに任意です。 sample_rows は、その接続で共有を有効にした場合にのみ行を返します。

---

トラブルシューティング

• 「Tabellum is not running」 — アプリを開いてから、もう一度お試しください。
• トークン再生成後に認証されない — クライアントで MCP サーバーを再起動し、シムに ~/.tabellum/mcp.json を再読み込みさせてください。
• 書き込みが止まっているように見える — アプリでの承認待ちです。10 分後に declined: timeout を返します。

サポート

• ウェブサイト：https://tabellum.dudko.dev
• お問い合わせ先：[email protected]