dsh-dbhub-live

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

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

✨ 特徴

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

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

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

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

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

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

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;"

ツール

注：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 はプラグインによって変更されません。

データの保存場所

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

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

アンインストール

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

トラブルシューティング

ライセンス

MIT