Skip to main content
Glama
mr-mihu

dsh-dbhub-live

by mr-mihu

dsh-dbhub-live

DeepSeek Harness (DSH) がデータベースを直接・安全に操作できるようにします:常駐マルチソース接続 + ワークスペース別ツール + 一時的な動的接続。

License: MIT DSH DBHub

dsh-dbhub-live は DSH プラグインであり、DBHub(データベース MCP サーバー)をベースに、モデルがデータベースを直接クエリできるようにします:設定済みのワークスペースで常駐接続を再利用するだけでなく、任意のデータベースに一時的に接続して一度きりの調査も可能です。

✨ 特徴

  • 常駐マルチソースサービス — バックグラウンドの1つの dbhub サービスが複数のデータソースを同時に接続し、接続を再利用してクエリを高速化。

  • ワークスペース別ツール — dbhub_execute_sql_<ワークスペース> / dbhub_search_objects_<ワークスペース>、ツール名がワークスペース名となり、複数ワークスペースが混ざらず、接続ラベル(パスワードはマスク)が明確に表示されます。

  • 一時動的接続 — dbhub_query / dbhub_query_objects は毎回独立して任意のデータベースに接続し、複数の異なるデータベースを並行して調査でき、クロス環境のトラブルシューティングに便利です。

  • すぐに使える — dbhub がインストールされていない場合、初回使用時に自動インストールされ、その後は自動的に最新版に更新されるため、手動で処理する必要はありません。

  • 複数の設定方法 — 明示的な DSN / 項目ごとの入力 / プロジェクト設定ファイルのスキャン認証、認証情報はローカルユーザーディレクトリにのみ保存され、パスワードは常にマスクされます。

Related MCP server: mcp-ohmy-sql

サポートされるデータソース

MySQL · PostgreSQL · MariaDB · SQLite · SQL Server

環境要件

  • DeepSeek Harness の dsh CLI(dsh web が GUI 実行を担当)

  • ローカルに Node.js ≥ 18(npm 含む)を推奨 — 初回使用時に dbhub が自動インストールされます

インストール

# 方式一:使用本机已安装的 dsh
dsh plugin --profile web add dsh-dbhub-live

# 方式二:通过 npx 调用 dsh(无需本机全局安装 dsh)
npx @deepseek-ai/dsh plugin --profile web add dsh-dbhub-live

インストール後、dsh web を再起動 して有効にします。

クイックスタート

# 1) 为当前工作区配置数据库连接(三种方式任选其一)
dbhub_configure

# 2) 在已配置工作区的常驻连接上执行查询
dbhub_execute_sql_myapp  SELECT * FROM users LIMIT 10;

# 3) 临时连任意库做一次性排查
dbhub_query  dsn=mysql://root:pass@192.168.77.6:3306/tx_sd_jinengshu  sql="SHOW TABLES;"

ツール

ツール

説明

dbhub_configure(workspace?, dsn?)

ワークスペースにデータベース接続を設定/永続化します。

dbhub_execute_sql_<ワークスペース>

指定されたワークスペースの常駐接続で SQL を実行します。

dbhub_search_objects_<ワークスペース>

指定されたワークスペースでデータベースオブジェクト(テーブル/ビュー/カラム/インデックスなど)を検索します。

dbhub_query(dsn, sql)

任意のデータベースに一時的に接続して SQL を実行します(複数ステートメントは ; で区切ります)。

dbhub_query_objects(dsn, ...)

任意のデータベースに一時的に接続してデータベースオブジェクトを検索します。

注:search_objects は SQLite のみで利用可能です。MySQL / PostgreSQL などでは dbhub_query で直接クエリしてください(例:SHOW TABLES)。

設定方法

  1. 明示的な DSN — 完全な接続文字列を渡します(例:mysql://user:pass@host:3306/db)。

  2. 項目ごとの入力 — タイプ / ホスト / ポート / アカウント / パスワード / データベース名を順に入力します。

  3. スキャン認証 — 認証後、プロジェクト設定ファイル(.env、application*.yml、docker-compose、jdbc.properties など)をスキャンし、候補(パスワードはマスク)をリストアップして確認を求めます。

ワークスペースに既に mise env または .env(DSN / DB_*)がある場合、プラグインは自動的に検出するため、手動設定は不要です。

🔄 dbhub の自動インストールと更新

  • 初回使用時に自動インストール:ローカルに dbhub がない場合、プラグインは最初のクエリ時に自動インストールし、その後はオフラインでも使用可能です。

  • 自動的に最新版を維持:7日ごとにバックグラウンドで静かに最新版に更新し、失敗した場合は既存のバージョンを維持します。

  • 設定を変更しない:PATH / mise で手動インストールした dbhub はプラグインによって変更されません。

環境変数

説明

デフォルト

DSH_DBHUB_PACKAGE

自動インストールに使用する npm パッケージ名

@bytebase/dbhub

DSH_DBHUB_UPDATE_DAYS

自動更新の間隔(日数)、0 で無効

7

データの保存場所

すべての設定と認証情報はモジュールディレクトリの外部(pnpm パッケージの影響を受けない場所)に保存されます。このディレクトリを削除すると完全にクリアされます:

~/.dsh/storages/dsh-dbhub-live/

アンインストール

dsh plugin --profile web remove dsh-dbhub-live

トラブルシューティング

現象

処理

初回使用時に「dbhub を取得できません」と表示される

ローカルに npm があり、ネットワークに接続できることを確認してください。オフラインの場合は手動で dbhub をインストールし、PATH に追加してください。

ツールに「dbhub サービスが利用できません」と表示される

dsh web のログを確認してください。プロセスが異常終了した場合、プラグインは次回呼び出し時に自動的に再起動します。

設定ファイルがスキャンされない

デフォルトで node_modules / .git / target / dist などのディレクトリはスキップされます。「DSN を入力」または「項目ごとに入力」を使用してください。

カスタムの dbhub バージョンが必要

~/.dsh/storages/dsh-dbhub-live を削除し、DSH_DBHUB_PACKAGE を設定してパッケージ/バージョンを指定してください。

dbhub の自動更新を無効にしたい

環境変数 DSH_DBHUB_UPDATE_DAYS=0 を設定してください。

ライセンス

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP Database Server is a service that provides secure database access for AI assistants and LLM-based tools, supporting SQLite, PostgreSQL, MySQL and MariaDB, and featuring query verification, audit logs and security control functions.
    2
    Apache 2.0
  • -
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that bridges AI assistants with SQL databases, enabling natural language querying across multiple database types with built-in optimization and security.
    3
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server for querying and managing multiple database types (PostgreSQL, MySQL, SQL Server, etc.) via natural language through AI assistants.
    GPL 3.0