bytebase/dbhub

DBHub – AI駆動のデータベースアクセスのための、軽量でトークン効率の高いMCPサーバー

概要 – DBHubは、AI搭載ツール（Claude Desktop/Code、Cursor、VS Code、Copilot CLIなど）が実際の関係データベースと通信できるようにする軽量な Model-Connect-Protocol (MCP) サーバーです。単一のプロセスとして実行され、外部依存関係はゼロで、LLMがデータを安全に探索またはクエリするために必要な必須ツールのみを公開します。

AI/MLにおける重要性 – 現代のLLMベースのエージェントは、モデルのコンテキストウィンドウを消費せずにSQLを実行する方法を必要としています。DBHubのデフォルトツールセット（execute_sqlとsearch_objectsのみ）は、競合するMCPサーバーよりも10倍以上小さい約1.4kトークンに収まります。これにより、モデルのプロンプトスペースを実際の推論タスクにより多く割り当てることができ、DBHubは言語モデルと本番データベース間の実用的なブリッジとなります。

主な機能

• トークン効率の高いコア – 2つの組み込みツールで1.4kトークン。
• マルチデータベースサポート – PostgreSQL、MySQL、MariaDB、SQL Server、Oracle、SQLite。
• 単一のTOMLファイルによるマルチ接続 – 1つのDBHubプロセスで複数のデータベースを運用。
• 安全ガードレール – 読み取り専用モード、行制限、クエリタイムアウト、SSHトンネリング、TLS暗号化。
• オプションの追加ツール – explain_sql、health_check、およびユーザー定義のカスタムツール。
• 組み込みのWebワークベンチ – ビジュアルクエリコンソールとリクエストトレースビューア。
• ランタイム依存関係ゼロ – Node ≥ 22.5のみ（組み込みの node:sqlite を使用）。

典型的なユースケース

1. ローカル開発 – Claude CodeやVS Codeを使用して、エディタを離れることなくスキーマの探索、クエリの検証、データのデバッグを行う。
2. 非技術者向けダッシュボード – AIアシスタントを通じて、読み取り専用でレート制限されたビューをビジネスユーザーに公開する。
3. 統合データベースゲートウェイ – 複数の個別のMCPサーバーを1つのDBHubインスタンスに置き換える。
4. 本番環境のトラブルシューティング – サービスが誤動作した際に、LLMから安全な読み取り専用の診断を実行する。

はじめ方

# クイックワンライナー (npm) – ポート8080でHTTPベースのMCPサーバーを実行
npx @bytebase/dbhub@latest \
  --transport http \
  --port 8080 \
  --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

その他のデプロイオプション：

• Dockerイメージ (Docker Hubからプル)
• MCP Bundle (ワンクリック、読み取り専用モード)
• Claude Codeプラグイン (Claude UIへの直接統合)

開発ワークフロー

pnpm install          # 開発依存関係のインストール
pnpm dev              # ホットリロードで実行
pnpm build && pnpm start --transport stdio --dsn "postgres://…"

リポジトリには、マルチデータベース設定用の dbhub.toml、/docs/images/workbench 配下のWebワークベンチ、およびテスト/デバッグドキュメントが含まれています。

開発元 – このプロジェクトは、エンタープライズグレードのデータベースMCPプラットフォームを提供するBytebaseによって保守されています。READMEには、より強力なガードレールを必要とするチーム向けの完全なBytebase製品へのリンクがあります。

---

すべての詳細はリポジトリのREADMEから直接引用したものであり、追加機能は推測されていません。