DBハブ | Glama

DBHubは、モデルコンテキストプロトコル（MCP）サーバーインターフェースを実装した汎用データベースゲートウェイです。このゲートウェイにより、MCP対応クライアントは様々なデータベースに接続し、情報を参照することができます。

 +------------------+    +--------------+    +------------------+
 |                  |    |              |    |                  |
 |                  |    |              |    |                  |
 |  Claude Desktop  +--->+              +--->+    PostgreSQL    |
 |                  |    |              |    |                  |
 |      Cursor      +--->+    DBHub     +--->+    SQL Server    |
 |                  |    |              |    |                  |
 |     Other MCP    +--->+              +--->+     SQLite       |
 |      Clients     |    |              |    |                  |
 |                  |    |              +--->+     MySQL        |
 |                  |    |              |    |                  |
 |                  |    |              +--->+    MariaDB       |
 |                  |    |              |    |                  |
 +------------------+    +--------------+    +------------------+
      MCP Clients           MCP Server             Databases

デモ SSE エンドポイント

https://demo.dbhub.ai/sse はサンプルの従業員データベースに接続します。Cursor または MCP Inspector でデータベースを指定して、実際の動作を確認できます。

サポートされているマトリックス

データベースリソース

リソース名	URI形式	PostgreSQL	MySQL	マリアDB	SQL サーバー	SQLite
スキーマ	`db://schemas`	✅	✅	✅	✅	✅
スキーマ内のテーブル	`db://schemas/{schemaName}/tables`	✅	✅	✅	✅	✅
スキーマ内のテーブル構造	`db://schemas/{schemaName}/tables/{tableName}`	✅	✅	✅	✅	✅
テーブル内のインデックス	`db://schemas/{schemaName}/tables/{tableName}/indexes`	✅	✅	✅	✅	✅
スキーマ内の手順	`db://schemas/{schemaName}/procedures`	✅	✅	✅	✅	❌
スキーマ内の手順の詳細	`db://schemas/{schemaName}/procedures/{procedureName}`	✅	✅	✅	✅	❌

データベースツール

道具	コマンド名	PostgreSQL	MySQL	マリアDB	SQL サーバー	SQLite
SQLを実行する	`execute_sql`	✅	✅	✅	✅	✅
リストコネクタ	`list_connectors`	✅	✅	✅	✅	✅

プロンプト機能

プロンプト	コマンド名	PostgreSQL	MySQL	マリアDB	SQL サーバー	SQLite
SQLを生成する	`generate_sql`	✅	✅	✅	✅	✅
DB要素を説明する	`explain_db`	✅	✅	✅	✅	✅

インストール

ドッカー

# PostgreSQL example
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport sse \
   --port 8080 \
   --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

# Demo mode with sample employee database
docker run --rm --init \
   --name dbhub \
   --publish 8080:8080 \
   bytebase/dbhub \
   --transport sse \
   --port 8080 \
   --demo

国立博物館

# PostgreSQL example
npx @bytebase/dbhub --transport sse --port 8080 --dsn "postgres://user:password@localhost:5432/dbname"

# Demo mode with sample employee database
npx @bytebase/dbhub --transport sse --port 8080 --demo

注: デモモードには、従業員、部門、給与などのテーブルを含むバンドルされた SQLite サンプル「従業員」データベースが含まれています。

クロードデスクトップ

Claude Desktop はstdioトランスポートのみをサポートしていますhttps://github.com/orgs/modelcontextprotocol/discussions/16

// claude_desktop_config.json
{
  "mcpServers": {
    "dbhub-postgres-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "bytebase/dbhub",
        "--transport",
        "stdio",
        "--dsn",
        // Use host.docker.internal as the host if connecting to the local db
        "postgres://user:password@host.docker.internal:5432/dbname?sslmode=disable"
      ]
    },
    "dbhub-postgres-npx": {
      "command": "npx",
      "args": [
        "-y",
        "@bytebase/dbhub",
        "--transport",
        "stdio",
        "--dsn",
        "postgres://user:password@localhost:5432/dbname?sslmode=disable"
      ]
    },
    "dbhub-demo": {
      "command": "npx",
      "args": ["-y", "@bytebase/dbhub", "--transport", "stdio", "--demo"]
    }
  }
}

カーソル

カーソルはstdioとsseの両方をサポートします。
カーソル MCP ガイドに従い、必ずエージェントモードを使用してください。

使用法

読み取り専用モード

DBHub を読み取り専用モードで実行できます。これにより、SQL クエリの実行が読み取り専用操作に制限されます。

# Enable read-only mode
npx @bytebase/dbhub --readonly --dsn "postgres://user:password@localhost:5432/dbname"

読み取り専用モードでは、読み取り専用の SQL 操作のみが許可されます。

これにより、実稼働データベースに接続するときにセキュリティがさらに強化されます。

データベース接続を構成する

テスト用にサンプル従業員データベースを使用して、DBHub をデモモードで使用できます。

npx @bytebase/dbhub  --demo

実際のデータベースでは、データベースソース名（DSN）が必要です。これはいくつかの方法で指定できます。

コマンドライン引数（最高優先度）:
npx @bytebase/dbhub --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
環境変数（第2優先度）:
export DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable" npx @bytebase/dbhub
環境ファイル（優先度3）:
- 開発の場合: DSNで.env.localを作成します
- 本番環境の場合: DSN GXP11 で.envを作成します。

[!警告] Dockerで実行する場合、ホストマシンで実行されているデータベースに接続するには、 localhostではなくhost.docker.internalを使用してください。例： mysql://user:password@host.docker.internal:3306/dbname

DBHub は次のデータベース接続文字列形式をサポートしています。

データベース	DSNフォーマット	例
MySQL	`mysql://[user]:[password]@[host]:[port]/[database]`	`mysql://user:password@localhost:3306/dbname`
マリアDB	`mariadb://[user]:[password]@[host]:[port]/[database]`	`mariadb://user:password@localhost:3306/dbname`
PostgreSQL	`postgres://[user]:[password]@[host]:[port]/[database]`	`postgres://user:password@localhost:5432/dbname?sslmode=disable`
SQL サーバー	`sqlserver://[user]:[password]@[host]:[port]/[database]`	`sqlserver://user:password@localhost:1433/dbname`
SQLite	`sqlite:///[path/to/file]`または`sqlite::memory:`	`sqlite:///path/to/database.db` 、 `sqlite:C:/Users/YourName/data/database.db (windows)`または`sqlite::memory:`

SQL サーバー

追加のクエリパラメータ:

認証

authentication=azure-active-directory-access-token 。Azureから実行する場合にのみ適用されます。DefaultAzureCredential を参照してください。

輸送

stdio (デフォルト) - Claude Desktop などのツールと直接統合する場合:
npx @bytebase/dbhub --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"
sse - ブラウザおよびネットワーククライアントの場合:
npx @bytebase/dbhub --transport sse --port 5678 --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

コマンドラインオプション

オプション	説明	デフォルト
デモ	サンプル従業員データベースを使用してデモモードで実行する	`false`
dsn	データベース接続文字列	デモモードでない場合は必須
輸送	トランスポートモード: `stdio`または`sse`	`stdio`
ポート	HTTP サーバーポート ( `--transport=sse`を使用する場合にのみ適用されます)	`8080`
読み取り専用	SQL 実行を読み取り専用操作に制限する	`false`

デモモードでは、従業員、部門、役職、給与、部門従業員、部門マネージャーのテーブルを含むサンプル従業員データベースがロードされたインメモリSQLiteデータベースを使用します。サンプルデータベースには、テーブル作成、データロード、テスト用のSQLスクリプトが含まれています。

発達

依存関係をインストールします:
pnpm install
開発モードで実行:
pnpm dev
生産用にビルド:
pnpm build pnpm start --transport stdio --dsn "postgres://user:password@localhost:5432/dbname?sslmode=disable"

MCP Inspectorでデバッグする

標準入出力

# PostgreSQL example
TRANSPORT=stdio DSN="postgres://user:password@localhost:5432/dbname?sslmode=disable" npx @modelcontextprotocol/inspector node /path/to/dbhub/dist/index.js

南南東

# Start DBHub with SSE transport
pnpm dev --transport=sse --port=8080

# Start the MCP Inspector in another terminal
npx @modelcontextprotocol/inspector

DBHubサーバーの/sseエンドポイントに接続する

DBHub

Integrations