Dbhub

メモ

DBHub が提供する機能を超える、承認フロー、アクセス制御、データマスキング、監査ログなどのガードレールを組み込みで備えたエンタープライズレベルのデータベース MCP サーバーが必要な場合は、Bytebaseをご覧ください。

            +------------------+    +--------------+    +------------------+
            |                  |    |              |    |                  |
            |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
            |                  |    |              |    |                  |
            |  Claude Code     +--->+              +--->+    SQL Server    |
            |                  |    |              |    |                  |
            |  Cursor          +--->+    DBHub     +--->+    Oracle        |
            |                  |    |              |    |                  |
            |  VS Code         +--->+              +--->+    SQLite        |
            |                  |    |              |    |                  |
            |  Copilot CLI     +--->+              +--->+    MySQL         |
            |                  |    |              |    |                  |
            |                  |    |              +--->+    MariaDB       |
            |                  |    |              |    |                  |
            +------------------+    +--------------+    +------------------+
                 MCP Clients           MCP Server             Databases

DBHub は、トークン効率に優れ、依存関係がなく、デフォルトではツールが2つだけの最小構成の MCP サーバーです。必要に応じて追加機能を有効にできます。この軽量なゲートウェイを使用すると、MCP 対応クライアントからさまざまなデータベースに接続して、内容を調べることができます。

• 最小構成：依存関係がなく、トークン効率に優れています。コンテキストウィンドウを最大限に活用できるよう、MCP ツールを最小限にしています
• マルチデータベース：単一のインターフェースから PostgreSQL、MySQL、MariaDB、SQL Server、Oracle、SQLite を利用できます
• マルチ接続：TOML 設定を使って複数のデータベースに同時に接続できます
• ガードレール：読み取り専用モード、行数制限、クエリタイムアウトにより、制御不能な操作を防ぎます
• 安全なアクセス：SSH トンネリングと SSL/TLS 暗号化に対応しています

DBHub は、MCP 経由で PostgreSQL に接続する方法を紹介するClaude Code のドキュメントにおける公式の例です。

トークン効率

DBHub はデフォルトでツールを2つだけ読み込み、必要なトークンは1.4kです。これは他の選択肢より13～14倍少なく、実際の作業に使えるコンテキストウィンドウを確保できます。

MCP サーバー	デフォルト設定	デフォルトのツール
DBHub	1.4k	2（execute_sql、search_objects）
MCP Toolbox	19.0k	28
Supabase MCP	19.3k	すべて

ユースケース

• ローカル開発：Claude Code、VS Code、Cursor などを使ったスキーマの調査、クエリの検証、データのデバッグ
• 非技術者のアクセス：Claude Desktop、VS Code、Cursor などを介して、厳選した読み取り専用ビューを非技術者に公開
• 複数データベースの統合：データベースごとに個別の MCP サーバーを用意する代わりに、単一の DBHub プロセスに置き換え
• 本番環境のトラブルシューティング：制御不能なクエリを防ぐガードレールを備えた読み取り専用の診断

対応データベース

PostgreSQL、MySQL、SQL Server、MariaDB、Oracle、SQLite。

MCP ツール

DBHub は、データベース操作向けの MCP ツールを実装しています。

• execute_sql：トランザクション対応と安全制御を備えた SQL クエリの実行
• search_objects：段階的な情報開示により、データベースのスキーマ、テーブル、カラム、インデックス、プロシージャを検索・調査
• explain_sql（オプトイン）：クエリを実行せずに実行計画を表示
• health_check（オプトイン）：接続プールの状態とバッファキャッシュのヒット率を報告
• カスタムツール：dbhub.toml 設定ファイルで、再利用可能なパラメーター付き SQL 操作を定義

ワークベンチ

DBHub には、データベースツールを操作するための組み込みウェブインターフェースが含まれています。MCP クライアントを必要とせず、クエリの実行、カスタムツールの実行、リクエストトレースの表示を視覚的に行えます。

インストール

npx @bytebase/dbhub@latest --transport http --port 8080 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

以下でも利用できます：

• Docker イメージ
• MCP Bundle（ワンクリックでインストール、読み取り専用）
• Claude Code プラグイン

すべてのオプションについてはインストールガイド、パラメーターについてはコマンドラインオプション、複数のデータベースを同時に接続する方法については複数データベースの設定をご覧ください。

開発

Node.js >= 22.5.0 が必要です（DBHub は組み込みの node:sqlite モジュールを使用します）。

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build and run for production
pnpm build && pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname"

テストとデバッグをご覧ください。

コントリビューター

スター履歴