Dbmcp

🚀 DBChat - AIを使ってデータベースと会話しよう

データベースをインテリジェントな会話パートナーに変えましょう。平文の英語で質問を投げかけ、即座に回答を得ることができ、美しいビジュアライゼーションも作成できます。これらすべてがClaude Desktopを通じて可能です。

🌟 DBChatとは何ですか？

DBChatは、Claude Desktopのような任意のMCPクライアントをデータベースに接続する架け橋です。これにより、自然言語でデータベースと対話することが可能になります。SQLクエリを書く代わりに、Claudeにデータに関する質問を投げかけるだけで、即座にインテリジェントな回答を得ることができます。

DBChat導入前:

SELECT c.name, COUNT(o.id) as order_count, SUM(o.total) as revenue 
FROM customers c 
LEFT JOIN orders o ON c.id = o.customer_id 
WHERE o.created_at >= '2024-01-01' 
GROUP BY c.id, c.name 
ORDER BY revenue DESC 
LIMIT 10;

DBChat導入後:

"今年の収益上位10社の顧客を教えて"

🎯 DBChatを使う理由は何ですか？

🗣️ 自然言語によるデータベースクエリ

• 平文の英語で質問: 「先月に新規登録した顧客は何人ですか？」
• 会話形式の回答: Claudeがデータを説明し、洞察を提供します
• SQL知識不要: ビジネスユーザーやアナリストに最適

📊 即時データビジュアライゼーション

• 自動チャート作成: Claudeがデータから美しいチャートを生成します
• 複数のチャートタイプ: 折れ線グラフ、棒グラフ、円グラフ、散布図など
• 対話的な洞察: フォローアップの質問でデータを掘り下げることができます

🔍 スマートなデータ探索

• データベースの発見: 「どんなテーブルがありますか？」「顧客テーブルの構造を教えて」
• 関係性の理解: Claudeがテーブル間の関係を説明します
• データ品質の洞察: 重複データ、欠損データ、異常値を見つけることができます

💼 ビジネスインテリジェンスの簡素化

• エグゼクティブダッシュボード: 「取締役会議用の売上サマリーを作成して」
• トレンド分析: 「過去6か月間のユーザー成長を教えて」
• パフォーマンス指標: 「売れ行きの悪い商品はどれですか？」

🗃️ サポートされるデータベース

DBChatは、実質的にすべてのデータベースで動作します（JDBCドライバがある限り）。

人気のデータベース

• MySQL / MariaDB - Webアプリケーションやeコマース
• Oracle - エンタープライズアプリケーション
• PostgreSQL - 高度なアプリケーションや分析
• SQL Server - Microsoft環境
• H2 - テストや開発
• SQLite - ローカルアプリケーションやプロトタイプ
• HSQLDB - テストや開発

分析とクラウド

• Snowflake - クラウドデータプラットフォーム
• Databricks - クラウドデータプラットフォーム
• Amazon Redshift - AWSデータウェアハウス
• Google BigQuery - Googleアナリティクス
• ClickHouse - リアルタイム分析

フラットファイルベースのデータ

• CSVファイル - スプレッドシートデータやエクスポート
• Excelファイル - CSVにエクスポートしてクエリを実行できます

完全なリストとビルドオプションについては、INSTALL.mdを参照してください。

🚀 クイックスタート

ステップ1: ダウンロード

GitHub Releasesから最新のリリースをダウンロードします。

• dbchat-2.0.4.jar - 基本バージョン (PostgreSQL, SQLite, H2, HSQLDB, CSV)
• dbchat-2.0.4.jar - 標準バージョン (MySQL, MariaDB, ClickHouseを追加)
• dbchat-2.0.4.jar - エンタープライズバージョン (Oracle, SQL Server, DB2を追加)
• dbchat-2.0.4.jar - すべてのデータベースを含む (400MB以上)

注意: 必要なドライバのみを含むカスタムJARをビルドすることもできます。詳細はINSTALL.mdを参照してください。

重要: インストールするJDBCドライバを使用するための適切なライセンスを持っていることを確認してください。DBChatのライセンスは、サードパーティのコードやバイナリをカバーしていません。

ステップ2: Claude Desktop（または他のMCPクライアント）をインストールする

1. Claude Desktopをダウンロードします（無料）
2. Claudeアカウントでサインインします
3. 重要: ClaudeのウェブサイトはMCPをサポートしていません。AnthropicモデルでMCPを使用するには、Claude Desktopを使用する必要があります。

ステップ3: データベース接続を設定する

設定ファイルdbchat.confを作成します。

# 基本的なデータベース接続
DB_URL=jdbc:mysql://localhost:3306/your_database
DB_USER=your_username
DB_PASSWORD=your_password
DB_DRIVER=com.mysql.cj.jdbc.Driver

# オプション: Webインターフェイスを有効にする
HTTP_MODE=false
HTTP_PORT=8080

人気のデータベースの例:

MySQL:

DB_URL=jdbc:mysql://localhost:3306/your_database
DB_USER=your_username
DB_PASSWORD=your_password
DB_DRIVER=com.mysql.cj.jdbc.Driver

PostgreSQL:

DB_URL=jdbc:postgresql://localhost:5432/your_database
DB_USER=your_username
DB_PASSWORD=your_password
DB_DRIVER=org.postgresql.Driver

SQLite:

DB_URL=jdbc:sqlite:/path/to/your/database.db
DB_USER=
DB_PASSWORD=
DB_DRIVER=org.sqlite.JDBC

H2でのテスト（設定不要）:

DB_URL=jdbc:h2:mem:testdb
DB_USER=sa
DB_PASSWORD=
DB_DRIVER=org.h2.Driver

ステップ4: Claude Desktopを設定する

1. Claude Desktopを開きます
2. 設定 → 開発者 → 設定を編集に移動します
3. データベースサーバーを追加します。

{
  "mcpServers": {
    "database": {
      "command": "java",
      "args": [
        "-jar", 
        "/absolute/path/to/dbchat-2.0.4.jar",
        "--config_file=/absolute/path/to/dbchat.conf"
      ]
    }
  }
}

設定ファイルを使用しない場合の代替案:

{
  "mcpServers": {
    "database": {
      "command": "java",
      "args": ["-jar", "/absolute/path/to/dbchat-2.0.4.jar"],
      "env": {
        "DB_URL": "jdbc:mysql://localhost:3306/your_database",
        "DB_USER": "your_username", 
        "DB_PASSWORD": "your_password",
        "DB_DRIVER": "com.mysql.cj.jdbc.Driver"
      }
    }
  }
}

Windowsの例:

{
  "mcpServers": {
    "database": {
      "command": "java",
      "args": [
        "-jar", 
        "C:/Users/YourName/Downloads/dbchat-2.0.4.jar",
        "--config_file=C:/Users/YourName/dbchat.conf"
      ]
    }
  }
}

注意: javaがPATHに含まれていない場合は、コマンドでjava（JDK 17+）の完全パスを使用してください。

ステップ5: 複数のデータベースを接続する

複数のデータベースを同時に使用することができます！

{
  "mcpServers": {
    "production-db": {
      "command": "java",
      "args": ["-jar", "/path/to/dbchat-2.0.4.jar"],
      "env": {
        "DB_URL": "jdbc:mysql://prod-server:3306/production",
        "DB_USER": "readonly_user",
        "DB_PASSWORD": "secure_password",
        "DB_DRIVER": "com.mysql.cj.jdbc.Driver",
        "SELECT_ONLY": "true"
      }
    },
    "analytics-db": {
      "command": "java", 
      "args": ["-jar", "/path/to/dbchat-2.0.4.jar"],
      "env": {
        "DB_URL": "jdbc:postgresql://analytics:5432/warehouse",
        "DB_USER": "analyst",
        "DB_PASSWORD": "password",
        "DB_DRIVER": "org.postgresql.Driver"
      }
    }
  }
}

ステップ6: Claude Desktopを再起動する

Claude Desktopを閉じて再度開きます。チャット入力欄にデータベース接続インジケータが表示されるはずです。

💬 データベースとの会話を始めましょう

データ探索

"データベースにはどんなテーブルがありますか？"
"顧客テーブルの構造を教えて"
"各テーブルには何件のレコードがありますか？"

ビジネス関連の質問

"先月に新規登録した顧客は何人ですか？"
"今四半期の売上上位5商品は何ですか？"
"過去1年間の月別収益を教えて"

データ分析

"6か月間注文のない顧客を見つけて"
"重複するメールアドレスはありますか？"
"顧客セグメント別の平均注文価値はいくらですか？"

ビジュアライゼーション

"月別売上トレンドを示すチャートを作成して"
"商品カテゴリ別の注文の円グラフを作成して"
"地域別の顧客新規登録数の棒グラフを教えて"

高度な分析

"各セグメントの顧客生涯価値を計算して"
"売上データの季節性トレンドを特定して"
"顧客の年齢と購買行動の相関を見つけて"

📱 実世界でのより多くの例

eコマース分析

"訪問者から購入までのコンバージョンファネルを教えて"
"返品率が最も高い商品はどれですか？"
"日別売上パフォーマンスを示すダッシュボードを作成して"

顧客成功

"離脱の危険性のある顧客を見つけて"
"顧客満足度のトレンドを教えて"
"最も価値の高い顧客セグメントを特定して"

財務報告

"今四半期の損益計算書のサマリーを生成して"
"過去12か月間のキャッシュフロートレンドを教えて"
"部署別の費用内訳を作成して"

オペレーション管理

"すべての倉庫の在庫レベルを監視して"
"運送会社別の配送パフォーマンスを教えて"
"出荷プロセスのボトルネックを特定して"

📊 データビジュアライゼーションの例

DBChatにより、Claudeがデータベースから直接見事なビジュアライゼーションを作成することができます。

売上ダッシュボード

• 月別収益トレンド: 経時的な成長を示す折れ線グラフ
• 上位商品: 売れ行き上位の商品を示す棒グラフ
• 地域別パフォーマンス: 地域別の売上を示すヒートマップ
• 顧客セグメント: 収益分布を示す円グラフ

分析レポート

• ユーザー成長: 獲得トレンドを示す面グラフ
• パフォーマンス指標: 異なるKPIを組み合わせた多軸グラフ
• 比較分析: 異なる期間の並列ビジュアライゼーション

オペレーションダッシュボード

• 在庫レベル: リアルタイムの在庫可視化
• システムパフォーマンス: 主要指標の時系列グラフ
• 品質指標: トレンドと異常値を示す統計グラフ

🛡️ セキュリティ機能

読み取り専用モード

読み取り専用アクセスでデータを保護します。

SELECT_ONLY=true

クエリ制限

リソースの使用を制御します。

MAX_ROWS_LIMIT=1000
QUERY_TIMEOUT_SECONDS=30
MAX_SQL_LENGTH=10000

ローカル処理

• すべてのデータはマシン上に留まります
• 外部API呼び出しはありません
• 環境変数は暗号化されます
• セキュアなローカル通信

🌐 Webインターフェイス（オプション）

HTTPモードを有効にして、Webベースのアクセスを可能にします。

# HTTPリスナーをオンにする
HTTP_MODE=true
# ポート8080でリッスンする
HTTP_PORT=8080
# すべてのインターフェイスにバインドする（外部アクセスを許可する）
BIND_ADDRESS=0.0.0.0
# 注意: バインドアドレスが指定されていない場合は、ローカルホストのみにバインドされます（デフォルト、最も安全）

その後、http://localhost:8080/にアクセスします。たとえば、http://localhost:8080/healthを試して、ヘルスステータスを確認します。

CLI引数を使用して同様の設定を行うには、次のようにします。

# ローカルホストのみにバインドする（デフォルト、最も安全）
java -jar dbchat-2.0.4.jar --http_mode=true --http_port=8080

# すべてのインターフェイスにバインドする（外部アクセスを許可する）
java -jar dbchat-2.0.4.jar --http_mode=true --bind_address=0.0.0.0 --http_port=8080

# 特定のインターフェイスにバインドする
java -jar dbchat-2.0.4.jar --http_mode=true --bind_address=192.168.1.100 --http_port=8080

🔧 設定方法と優先順位

最大限の柔軟性を得るために、DBChatはCLI引数、設定ファイル、環境変数、システムプロパティ、および組み込みのデフォルトなど、複数の設定方法をサポートしています。トラブルシューティングや高度な設定には、優先順位を理解することが重要です。

設定の優先順位（高い順）

1. コマンドライン引数（最も高い優先順位）
2. 設定ファイル
3. 環境変数
4. システムプロパティ
5. 組み込みのデフォルト（最も低い優先順位）

これは、コマンドライン引数が常に設定ファイルを上書きし、設定ファイルが環境変数を上書きするなどの意味です。

方法1: コマンドライン引数

形式: --parameter_name=value 使用例: クイックオーバーライド、テスト、一度限りの設定

java -jar dbchat-2.0.4.jar \
  --config_file=/path/to/config.conf \
  --db_url="jdbc:mysql://localhost:3306/mydb" \
  --db_user="username" \
  --db_password="password" \
  --db_driver="com.mysql.cj.jdbc.Driver" \
  --http_mode=true \
  --http_port=8080 \
  --max_connections=20 \
  --connection_timeout_ms=30000 \
  --query_timeout_seconds=60 \
  --select_only=true \
  --max_sql_length=50000 \
  --max_rows_limit=10000

利用可能なパラメータ:

• --config_file=/path/to/config.conf
• --db_url="jdbc:..."
• --db_user="username"
• --db_password="password"
• --db_driver="com.mysql.cj.jdbc.Driver"
• --http_mode=true
• --http_port=8080
• --max_connections=20
• --connection_timeout_ms=30000
• --query_timeout_seconds=60
• --select_only=true
• --max_sql_length=50000
• --max_rows_limit=10000

方法2: 設定ファイル

形式: KEY=VALUE（1行に1つ） 使用例: 本番環境、複雑な設定、バージョン管理

ファイル（例: dbchat.conf）を作成します。

# データベース接続
DB_URL=jdbc:postgresql://localhost:5432/myapp
DB_USER=dbuser
DB_PASSWORD=my secure password with spaces
DB_DRIVER=org.postgresql.Driver

# 接続プール設定
MAX_CONNECTIONS=20
CONNECTION_TIMEOUT_MS=60000
IDLE_TIMEOUT_MS=300000
MAX_LIFETIME_MS=1800000
LEAK_DETECTION_THRESHOLD_MS=60000

# クエリ設定
QUERY_TIMEOUT_SECONDS=45
SELECT_ONLY=false
MAX_SQL_LENGTH=50000
MAX_ROWS_LIMIT=50000

# サーバー設定
HTTP_MODE=true
HTTP_PORT=8080

使用方法:

java -jar dbchat-2.0.4.jar --config_file=dbchat.conf

設定ファイルの機能:

• #で始まる行はコメントとなります
• 空行は無視されます
• 値は引用符で囲むことができます: DB_PASSWORD="password with spaces"
• キーは大文字と小文字を区別しません
• コマンドラインと同じパラメータをすべてサポートしています

方法3: 環境変数

形式: UPPERCASE_WITH_UNDERSCORES 使用例: Docker、クラウドデプロイメント、CI/CD、セキュアな資格情報管理

export DB_URL="jdbc:mysql://localhost:3306/mydb"
export DB_USER="username"
export DB_PASSWORD="password"
export DB_DRIVER="com.mysql.cj.jdbc.Driver"
export HTTP_MODE="true"
export HTTP_PORT="8080"
export SELECT_ONLY="true"

java -jar dbchat-2.0.4.jar

すべての環境変数:

• CONFIG_FILE - 設定ファイルへのパス
• DB_URL - データベース接続URL
• DB_USER - データベースユーザー名
• DB_PASSWORD - データベースパスワード
• DB_DRIVER - JDBCドライバクラス
• HTTP_MODE - HTTPモードを有効にする（true/false）
• HTTP_PORT - HTTPサーバーポート
• MAX_CONNECTIONS - 接続プールサイズ
• CONNECTION_TIMEOUT_MS - 接続タイムアウト
• QUERY_TIMEOUT_SECONDS - クエリタイムアウト
• SELECT_ONLY - 読み取り専用モード（true/false）
• MAX_SQL_LENGTH - 最大クエリ長
• MAX_ROWS_LIMIT - 最大結果行数
• IDLE_TIMEOUT_MS - 接続アイドルタイムアウト
• MAX_LIFETIME_MS - 接続最大寿命
• LEAK_DETECTION_THRESHOLD_MS - リーク検出閾値

方法4: システムプロパティ

形式: -Dparameter.name=value（アンダースコアはドットに変換） 使用例: JVM固有の設定、IDE実行構成

java -Ddb.url="jdbc:mysql://localhost:3306/mydb" \
     -Ddb.user="username" \
     -Ddb.password="password" \
     -Ddb.driver="com.mysql.cj.jdbc.Driver" \
     -Dhttp.mode="true" \
     -Dhttp.port="8080" \
     -jar dbchat-2.0.4.jar

プロパティ名: 環境変数DB_URLはシステムプロパティdb.urlになります。

方法5: 組み込みのデフォルト

適用条件: 設定が提供されていない場合 値: 開発用の安全なデフォルト

DB_URL=jdbc:h2:mem:testdb
DB_USER=sa
DB_PASSWORD=
DB_DRIVER=org.h2.Driver
HTTP_MODE=false
HTTP_PORT=8080
MAX_CONNECTIONS=10
CONNECTION_TIMEOUT_MS=30000
QUERY_TIMEOUT_SECONDS=30
SELECT_ONLY=true
MAX_SQL_LENGTH=10000
MAX_ROWS_LIMIT=10000

設定例

例1: 優先順位のオーバーライド

# 設定ファイルでHTTP_PORT=8080を設定
echo "HTTP_PORT=8080" > config.conf

# 環境変数で別のポートを設定
export HTTP_PORT=9090

# コマンドラインで両方を上書き
java -jar dbchat-2.0.4.jar --config_file=config.conf --http_port=7070

# 結果: ポート7070を使用（コマンドラインが勝つ）

例2: 混合設定

# データベース設定に設定ファイルを使用
echo "DB_URL=jdbc:mysql://localhost:3306/mydb" > prod.conf
echo "DB_USER=produser" >> prod.conf
echo "SELECT_ONLY=true" >> prod.conf

# 環境変数でパスワードをオーバーライド（より安全）
export DB_PASSWORD="secure_password"

# コマンドラインでポートをオーバーライド（この実行のみ）
java -jar dbchat-2.0.4.jar --config_file=prod.conf --http_port=9090

例3: Claude Desktop設定

{
  "mcpServers": {
    "database": {
      "command": "java",
      "args": [
        "-jar", "/path/to/dbchat-2.0.4.jar",
        "--config_file=/path/to/production.conf",
        "--select_only=true"
      ],
      "env": {
        "DB_PASSWORD": "secure_password_from_env"
      }
    }
  }
}

設定パラメータの参照

データベース接続

• DB_URL - JDBC接続文字列（必須）
• DB_USER - データベースユーザー名
• DB_PASSWORD - データベースパスワード
• DB_DRIVER - JDBCドライバクラス（必須）

接続プール

• MAX_CONNECTIONS=10 - 最大同時接続数
• CONNECTION_TIMEOUT_MS=30000 - 接続取得タイムアウト
• IDLE_TIMEOUT_MS=600000 - 接続アイドルタイムアウト（10分）
• MAX_LIFETIME_MS=1800000 - 接続最大寿命（30分）
• LEAK_DETECTION_THRESHOLD_MS=60000 - 接続リーク検出（1分）

クエリ設定

• QUERY_TIMEOUT_SECONDS=30 - SQLクエリ実行タイムアウト
• SELECT_ONLY=true - 読み取り専用モード（INSERT/UPDATE/DELETEをブロック）
• MAX_SQL_LENGTH=10000 - SQLクエリの最大文字数
• MAX_ROWS_LIMIT=10000 - クエリごとの最大返却行数

サーバー設定

• HTTP_MODE=false - HTTP Webインターフェイスを有効にする
• HTTP_PORT=8080 - HTTPサーバーポート

セキュリティのベストプラクティス

資格情報管理

# 良い例: パスワードに環境変数を使用
export DB_PASSWORD="secure_password"
java -jar dbchat-2.0.4.jar --config_file=app.conf

# 良い例: 制限付きパーミッションの設定ファイルを使用
chmod 600 secure.conf
java -jar dbchat-2.0.4.jar --config_file=secure.conf

# 避ける: コマンドラインにパスワードを記述（プロセスリストに表示される）
java -jar dbchat-2.0.4.jar --db_password="visible_password"

設定ファイルのセキュリティ

# セキュアな設定ファイルを作成
umask 077
cat > secure.conf << EOF
DB_PASSWORD=secure_password
EOF

# パーミッションを確認
ls -la secure.conf
# 表示されるはず: -rw------- (所有者のみ読み書き可能)

設定のトラブルシューティング

有効な設定を確認する

どの値が使用されているかを確認するには、デバッグログを有効にします。

java -Dlogging.level.root=DEBUG -jar dbchat-2.0.4.jar --config_file=myconfig.conf

一般的な問題

1. 設定ファイルが見つからない: 絶対パスを使用してください
2. アクセス拒否: ファイルのパーミッションを確認してください
3. 誤った値が使用されている: 優先順位を確認してください
4. 環境変数が設定されていない: env | grep DB_で確認してください

検証コマンド

# 現在の設定でデータベース接続をテストする
java -jar dbchat-2.0.4.jar --help

# 設定ファイルの構文を検証する
grep -v "^#" myconfig.conf | grep -v "^$"

# 環境変数を確認する
env | grep -E "(DB_|HTTP_|MAX_|SELECT_)"

🚫 トラブルシューティング

Claude Desktopが接続できない場合

1. パスを確認する: 設定で絶対パスを使用してください
2. Javaバージョン: Java 17以上がインストールされていることを確認してください
3. ファイルパーミッション: JARファイルが読み取り可能であることを確認してください
4. Claudeを再起動する: Claude Desktopを閉じて再度開きます

データベース接続の問題

1. 接続をテストする: データベースが実行中であることを確認してください
2. 資格情報を確認する: ユーザー名とパスワードが正しいことを確認してください
3. ネットワークアクセス: データベースが接続を許可していることを確認してください
4. ドライバサポート: データベースに適したJARバージョンを使用してください

パフォーマンスの問題

1. 結果を制限する: MAX_ROWS_LIMIT=1000を使用してください
2. クエリタイムアウト: QUERY_TIMEOUT_SECONDS=30を設定してください
3. 接続プール: MAX_CONNECTIONS=10を調整してください

一般的なエラーメッセージ

"ClassNotFoundException"

• データベースに適したJARバージョンをダウンロードしてください
• データベースドライバが含まれていることを確認してください

"Connection refused"

• データベースサーバーが実行中であることを確認してください
• 接続URL、ユーザー名、パスワードを確認してください
• データベースがあなたのマシンからの接続を許可していることを確認してください

"Server not responding"

• Claude Desktopの設定構文を確認してください
• JavaがPATHに含まれていることを確認してください
• Claude Desktopのログを確認してください

🎯 ベストプラクティス

始めるにあたって

1. 読み取り専用で始める: 最初はSELECT_ONLY=trueを使用してください
2. サンプルデータでテストする: まずH2データベースを試してみてください
3. 簡単な質問から始める: 基本的なテーブル探索から始めてください
4. 徐々に複雑さを増やす: 時間をかけて高度な分析に移行してください

セキュリティ

1. 専用のデータベースユーザーを使用する: DBChat用に読み取り専用のユーザーを作成してください
2. アクセスを制限する: 必要なテーブルの権限のみを付与してください
3. 使用状況を監視する: 定期的にクエリログを確認してください
4. データをバックアップする: 常にデータベースのバックアップを保持してください

パフォーマンス

1. 適切な制限を設定する: MAX_ROWS_LIMITとタイムアウトを使用してください
2. 重要な列にインデックスを付ける: クエリが効率的に実行できるようにしてください
3. リソースを監視する: CPUとメモリの使用状況を監視してください
4. クエリを最適化する: Claudeにクエリの改善案を提案させてください

📚 詳細を学ぶ

• モデルコンテキストプロトコル: modelcontextprotocol.io
• Claude Desktop: claude.ai/download
• 開発者ガイド: 技術的な詳細についてはINSTALL.mdを参照してください
• GitHubリポジトリ: github.com/skanga/dbchat

🚀 あなたのデータ体験を変革しましょう

1. データベースに適したJARファイルをダウンロードする
2. Claude Desktopをインストールする（無料）
3. データベース接続を設定する
4. Claude Desktopの設定にDBChatを追加する
5. データに関する質問を始める

データとの関係を変革しましょう。複雑なSQLクエリやレポートの待ち時間はもう必要ありません。ClaudeのインテリジェンスとDBChatのシームレスな統合により、データベースと自然な会話が可能になります。

今日から始めて、データがあなたに伝えようとしていることを発見しましょう。