Mysql MCP Webui

🚀 MySQL MCP Server

Model Context Protocol (MCP) を介して、Claude AI から直接 MySQL データベースにアクセスできるようにします。

MySQL MCP Server を使用すると、Claude Desktop と Claude Code が SQL クエリを実行し、データベースを探索し、MySQL データとやり取りできます。これはすべて、安全で権限管理されたインターフェースを通じて行われます。

🚀 クイックスタート

インストール

# npm を使ってグローバルにインストール
npm install -g mysql-mcp-webui

# または、npx で直接実行（インストール不要）
npx mysql-mcp-webui

Claude Desktop のセットアップガイド

重要: Claude Desktop を設定する前に、API トークンを生成する必要があります。以下の手順に従ってください。

ステップ 1: API トークンの生成

Claude Desktop をセットアップする前に、認証トークンを生成します。

mysql-mcp-webui --generate-token

これにより、次のような出力が表示されます。

✓ API トークンが正常に生成されました！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  mcp_abc123def456ghi789jkl012mno345pqr678stu901vwx234yz
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚠️  重要: このトークンを安全に保存してください！
   このトークンは再度表示されません。

このトークンをコピー して、次のステップで使用します。

ステップ 2: Claude Desktop の設定

Claude Desktop の設定ファイルに次の設定を追加します。

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

設定内容:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "mysql-mcp-webui"],
      "env": {
        "TRANSPORT": "stdio",
        "AUTH_TOKEN": "paste-your-token-here"
      }
    }
  }
}

paste-your-token-here をステップ 1 で生成したトークンに置き換えます。

注意: npm install -g でグローバルにインストールした場合は、args フィールドを使用せずに "command": "mysql-mcp-webui" を使用することもできます。

ステップ 3: Claude Desktop の起動

1. 設定ファイルを保存します。
2. Claude Desktop を完全に再起動します（終了してから再開）。
3. Claude Desktop は自動的に MCP サーバーを起動します。
4. Web UI は http://localhost:9274 で利用できます。

ステップ 4: MySQL 接続の設定

http://localhost:9274 で Web UI を開きます。

1. デフォルトの資格情報でログインします: admin / admin
   • 初回ログイン時にパスワードの変更を求められます。
2. MySQL 接続を追加します:
   • MySQL サーバーのホスト、ポート、ユーザー名、パスワードを入力します。
   • "Test Connection" をクリックして接続が機能することを確認します。
3. データベースを検出します:
   • "Discover Databases" をクリックして、利用可能なすべてのデータベースを自動検出します。
4. 権限を設定します:
   • 各データベースについて、Claude が実行できる操作を有効にします。
   • 本番データベースの場合は、最初は SELECT のみ を有効にします。
5. デフォルト接続を設定します（オプション）:
   • 新しい Claude Desktop インスタンスを起動しやすくなります。

ステップ 5: Claude の使用開始

設定は完了です！これで、Claude にデータベースを照会するように依頼できます。

あなた: "登録日順で上位 10 人のユーザーを表示して"
Claude: [mysql_query ツールを使用してデータを取得]

セットアップのトラブルシューティング

"AUTH_TOKEN is required" エラー:

• まず mysql-mcp-webui --generate-token を実行したことを確認してください。
• トークンが設定ファイルに正しく貼り付けられていることを確認してください（余分なスペースや引用符は不要）。
• 設定ファイルが有効な JSON であることを確認してください。

Claude Desktop が MCP サーバーを認識しない場合:

• 設定ファイルの場所が OS に適していることを確認してください。
• Claude Desktop を完全に再起動してください（終了してから再開、単なる再読み込みではない）。
• JSON の構文エラーを確認してください（JSON バリデーターを使用）。

Web UI にアクセスできない場合:

• サーバーは Claude Desktop が起動するときにのみ起動します。
• ポート 9274 がすでに使用されているかどうかを確認してください: lsof -i :9274 (macOS/Linux)
• env セクションに "HTTP_PORT": "3001" を追加して、別のポートを試してみてください。

✨ 主な機能

MCP とは何か

Model Context Protocol は、Claude のような AI アシスタントが外部のデータソースやツールに安全に接続できるようにするオープン標準です。この MySQL MCP Server はそのプロトコルを実装しており、Claude に以下の機能を提供します。

• 🔍 データベースを照会する - 自然言語で SQL クエリを実行する
• 📊 データを探索する - テーブルを閲覧し、スキーマを理解し、データを分析する
• 🔄 コンテキストを切り替える - 異なるデータベース間をシームレスに移動する
• 🔒 セキュリティを維持する - すべての操作は権限ルールに基づいて検証される

4 つの MCP ツール

構成が完了すると、Claude は MySQL データベースとやり取りするための 4 つの強力なツールを使用できます。

1. mysql_query - SQL クエリの実行

Claude は、自動的な権限検証を伴って、アクティブなデータベースに対して SQL クエリを実行できます。

会話の例:

あなた: "登録日順で上位 10 人のユーザーを表示して"

Claude は使用: mysql_query
SQL: SELECT id, username, email, created_at
     FROM users
     ORDER BY created_at DESC
     LIMIT 10

応答: [クエリ結果が表として表示される]

動作の流れ:

1. Claude はあなたの要求に基づいて適切な SQL を生成します。
2. クエリはデータベースの権限に基づいて検証されます（例: SELECT 権限が必要）。
3. トランザクション内で実行されます（エラー時に自動ロールバック）。
4. 結果は読みやすい形式でフォーマットされます。

2. list_databases - 利用可能なデータベースの探索

Claude は、あなたが構成したすべてのデータベースとその権限を確認できます。

会話の例:

あなた: "アクセスできるデータベースは何ですか？"

Claude は使用: list_databases
引数: { include_metadata: true }

応答:
- production_db (アクティブ)
  権限: SELECT
  テーブル: 45
  サイズ: 2.3 GB

- staging_db
  権限: SELECT, INSERT, UPDATE
  テーブル: 42
  サイズ: 856 MB

動作の流れ:

1. アクティブな MySQL 接続からすべてのデータベースをリストします。
2. 現在アクティブなデータベースを示します。
3. 各データベースの構成された権限を表示します。
4. 必要に応じてメタデータ（テーブル数、サイズ）を含めます。

3. switch_database - アクティブなデータベースの切り替え

Claude は、データベースの別名を使用して、MySQL 接続内のデータベースを切り替えることができます。

会話の例:

あなた: "代わりにステージングデータベースを見てみましょう"

Claude は使用: switch_database
引数: { database: "staging_db" }

応答: ✓ production_db から staging_db に切り替えました
権限: SELECT, INSERT, UPDATE, DELETE
これで staging_db のデータを照会し、変更を加えることができます

動作の流れ:

1. 接続内にデータベースが存在することを検証します。
2. すべての将来のクエリのアクティブなデータベースを切り替えます。
3. 新しいデータベースの権限を返します。
4. 変更を永続化します（再起動しても保持されます）。

4. add_connection - 新しい MySQL 接続の作成

Claude は、Web UI を使用せずに、プログラムで新しい MySQL データベース接続を追加できます。

会話の例:

あなた: "パスワード 'mypass' で root を使用して、localhost の MySQL サーバーに接続を追加して"

Claude は使用: add_connection
引数: {
  name: "Local MySQL",
  host: "localhost",
  port: 3306,
  user: "root",
  password: "mypass"
}

応答: ✓ 接続が正常に作成されました！
接続 ID: 1
名前: Local MySQL
検出されたデータベース: 5 つのデータベースが検出され、SELECT 権限で追加されました

動作の流れ:

1. 接続資格情報をテストして検証します。
2. パスワードを AES-256-GCM で暗号化してから保存します。
3. 接続をデータベースに保存します。
4. 利用可能なすべてのデータベースを自動検出します。
5. 検出されたデータベースにデフォルトの SELECT 権限を追加します。
6. 接続詳細と検出結果を返します。

その他の機能

• データ分析：自然言語でデータ分析を依頼できます。

あなた: "過去 6 か月間の月次収益トレンドはどうですか？"
Claude: mysql_query を使用して売上データを集計し、要約を提示します

• データベース探索：データベース内のテーブルやデータを探索できます。

あなた: "顧客情報を含むテーブルはどれですか？"
Claude: information_schema を照会し、テーブルの関係を説明します

• スキーマ理解：テーブルの構造やカラムの目的を理解できます。

あなた: "users テーブルの構造を説明して"
Claude: DESCRIBE クエリを使用し、各カラムの目的を説明します

• データ移行：データをあるデータベースから別のデータベースに移行できます。

あなた: "今年作成されたすべてのユーザーをアーカイブデータベースにコピーして"
Claude: データベースを切り替え、ソースを照会して宛先に挿入します

• デバッグ：データベース内の問題を特定して解決できます。

あなた: "重複注文が発生しているのはなぜですか？"
Claude: orders テーブルを照会し、データを分析して問題を特定します

📦 インストール

Claude Code (HTTP モード) のセットアップガイド

Claude Code は、HTTP モードを介して MySQL MCP Server に接続でき、リモートアクセスと複数の同時セッションをサポートします。

オプション 1: npx を使用する（Docker を使用しない）

ステップ 1: サーバーの起動

# デフォルトポート 9274 で HTTP モードで起動
TRANSPORT=http npx -y mysql-mcp-webui

# または、カスタムポートで起動
TRANSPORT=http HTTP_PORT=3001 npx -y mysql-mcp-webui

ステップ 2: API トークンの生成

http://localhost:9274（またはカスタムポート）で Web UI を開きます。

1. デフォルトの資格情報でログインします: admin / admin
2. API Keys セクションに移動します。
3. Generate New API Key をクリックします。
4. 生成されたキーをコピーします。

ステップ 3: Claude Code の設定

Claude Code の MCP 設定（.claude/mcp_settings.json または UI 経由）に次の内容を追加します。

{
  "mcpServers": {
    "mysql": {
      "type": "http",
      "url": "http://localhost:9274/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

リモート/本番デプロイの場合は、ドメインを使用します。

{
  "mcpServers": {
    "mysql": {
      "type": "http",
      "url": "https://yourdomain.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

オプション 2: Docker を使用する（本番環境で推奨）

ステップ 1: Docker でデプロイ

クイックスタート（クローン不要）:

# npm ベースの Docker イメージから直接実行
docker run -d \
  --name mysql-mcp \
  -p 9274:9274 \
  -v mysql-mcp-data:/app/data \
  -e TRANSPORT=http \
  -e NODE_ENV=production \
  mysql-mcp-webui

# または、ローカルでビルドして実行
docker build -t mysql-mcp-webui https://github.com/yashagldit/mysql-mcp-webui.git
docker run -d \
  --name mysql-mcp \
  -p 9274:9274 \
  -v mysql-mcp-data:/app/data \
  -e TRANSPORT=http \
  -e NODE_ENV=production \
  mysql-mcp-webui

docker-compose を使用する（高度な構成用）:

# カスタム docker-compose.yml が必要な場合のみクローン
git clone https://github.com/yashagldit/mysql-mcp-webui.git
cd mysql-mcp-webui
cp .env.example .env
# 必要に応じて .env を編集（ポートの変更、HTTPS の有効化など）
docker-compose up -d

ステップ 2: API キーの取得

# http://localhost:9274 で Web UI にアクセス
# ログイン: admin / admin
# API Keys → Generate New API Key に移動

ステップ 3: Claude Code の設定

{
  "mcpServers": {
    "mysql": {
      "type": "http",
      "url": "http://localhost:9274/mcp",
      "headers": {
        "Authorization": "Bearer your-docker-api-key-here"
      }
    }
  }
}

ステップ 4: MySQL 接続の設定

Claude Desktop のセットアップと同じで、Web UI を使用して以下の操作を行います。

1. MySQL 接続を追加します。
2. データベースを検出します。
3. 権限を設定します。
4. オプションでデフォルト接続を設定します。

Docker デプロイオプション

基本的な HTTP モード

docker run -d \
  --name mysql-mcp \
  -p 9274:9274 \
  -v mysql-mcp-data:/app/data \
  mysql-mcp-webui

カスタムポート

docker run -d \
  --name mysql-mcp \
  -p 3001:3001 \
  -v mysql-mcp-data:/app/data \
  -e HTTP_PORT=3001 \
  mysql-mcp-webui

HTTPS を使用する（本番環境）

docker run -d \
  --name mysql-mcp \
  -p 443:9274 \
  -v mysql-mcp-data:/app/data \
  -v /etc/letsencrypt:/app/certs:ro \
  -e ENABLE_HTTPS=true \
  -e SSL_CERT_PATH=/app/certs/live/yourdomain.com/fullchain.pem \
  -e SSL_KEY_PATH=/app/certs/live/yourdomain.com/privkey.pem \
  mysql-mcp-webui

docker-compose.yml を使用する

リポジトリには、すぐに使用できる docker-compose.yml が含まれています。

services:
  mysql-mcp:
    image: mysql-mcp-webui
    ports:
      - "9274:9274"
    volumes:
      - mysql-mcp-data:/app/data
    environment:
      - TRANSPORT=http
      - NODE_ENV=production
    restart: unless-stopped

volumes:
  mysql-mcp-data:

HTTPS、レート制限、セキュリティ強化を含む詳細な本番デプロイについては、DEPLOYMENT.md を参照してください。

📚 ドキュメント

動作原理

┌─────────────────────────────────────────────────────┐
│  あなた: "今月登録したユーザーを表示して"        │
└──────────────────┬──────────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────────┐
│  Claude Desktop / Claude Code                       │
│  - あなたの要求を理解する                         │
│  - mysql_query ツールを使用することを決定する       │
│  - 適切な SQL を生成する                         │
└──────────────────┬──────────────────────────────────┘
                   │ MCP プロトコル
┌──────────────────▼──────────────────────────────────┐
│  MySQL MCP Server                                   │
│  1. API トークンを検証する                         │
│  2. データベースの権限を確認する                   │
│  3. クエリの種類を実行前に検証する                 │
│  4. トランザクション内でクエリを実行する           │
│  5. 結果を返す                                     │
└──────────────────┬──────────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────────┐
│  あなたの MySQL データベース                        │
│  - クエリが安全に実行される                         │
│  - 結果が返される                                   │
└─────────────────────────────────────────────────────┘

権限システム

各データベースには細かい権限が設定されています。Claude が実行できる操作を構成します。

権限	許可される操作	例
SELECT	テーブルからデータを読み取る	"先週のすべての注文を表示して"
INSERT	新しいレコードを追加する	"新しいユーザーアカウントを作成して"
UPDATE	既存のレコードを変更する	"ユーザーのメールアドレスを更新して"
DELETE	レコードを削除する	"スパムコメントを削除して"
CREATE	テーブル/インデックスを作成する	"新しい分析テーブルを作成して"
ALTER	テーブル構造を変更する	"users テーブルに新しいカラムを追加して"
DROP	テーブル/データベースを削除する	"一時的なテストテーブルを削除して"
TRUNCATE	テーブルを空にする	"logs テーブルのすべてのデータをクリアして"

ベストプラクティス: 本番データベースの場合は、最初は SELECT のみ を使用します。必要に応じて追加の権限を付与します。

設定オプション

トランスポートモード

stdio モード（Claude Desktop のデフォルト）

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "mysql-mcp-webui"],
      "env": {
        "TRANSPORT": "stdio",
        "AUTH_TOKEN": "your-api-key",
        "HTTP_PORT": "9274"
      }
    }
  }
}

• MCP 通信は stdin/stdout を介して行われます（Claude Desktop によって管理されます）。
• Web UI は別の HTTP ポートで実行されます（デフォルト: 9274、カスタマイズ可能）。
• 各 Claude Desktop インスタンスは独自のプロセスを生成します。
• ローカル開発とデスクトップ使用に最適です。

stdio モードでのカスタムポート:

{
  "env": {
    "TRANSPORT": "stdio",
    "AUTH_TOKEN": "your-api-key",
    "HTTP_PORT": "3001"
  }
}

HTTP モード（Claude Code とリモートアクセス用）

# デフォルトポート 9274 で HTTP モードでサーバーを起動
TRANSPORT=http mysql-mcp-webui

# カスタムポート
TRANSPORT=http HTTP_PORT=3001 mysql-mcp-webui

# MCP エンドポイントは以下で利用可能:
# http://localhost:9274/mcp (またはカスタムポート)

• MCP 通信は /mcp の HTTP エンドポイントを介して行われます。
• 複数の同時セッションをサポートし、分離された状態を維持します。
• 同じポートで REST API と Web UI を含みます。
• リモートアクセス、Docker デプロイ、Claude Code に最適です。

環境変数

変数	デフォルト	説明
TRANSPORT	http	トランスポートモード: stdio または http
HTTP_PORT	9274	Web UI、API、および MCP エンドポイントのポート（両方のモードでカスタマイズ可能）
AUTH_TOKEN	-	API キー（stdio モードで必要）
NODE_ENV	development	環境: development または production
MCP_RESPONSE_FORMAT	json	MCP 応答形式: json または toon（以下の TOON 形式 を参照）
ENABLE_HTTPS	false	HTTPS/TLS を有効にする
SSL_CERT_PATH	-	SSL 証明書のパス（HTTPS を有効にした場合に必要）
SSL_KEY_PATH	-	SSL 秘密鍵のパス（HTTPS を有効にした場合に必要）
JWT_SECRET	(自動生成)	JWT トークンのシークレット（開発環境ではオプション、本番環境では推奨）
JWT_EXPIRES_IN	7d	JWT トークンの有効期限（例: 1h, 24h, 7d, 30d）
RATE_LIMIT_ENABLED	true	レート制限を有効にする
RATE_LIMIT_WINDOW_MS	900000	レート制限のウィンドウ（ミリ秒）（15 分）
RATE_LIMIT_MAX_REQUESTS	100	ウィンドウごとの最大リクエスト数

TOON 形式（トークン最適化）

MySQL MCP Server は、TOON (Token-Oriented Object Notation) をサポートしています。これは、JSON と比較して約 40% 少ないトークンでクエリ結果を Claude に返すための最適化された形式です。

TOON を使用する場合:

• 大規模なクエリ結果（100 行以上）
• トークン使用量が重要なコストに敏感なアプリケーション
• コンテキストウィンドウの効率を最大化する場合

有効化方法:

Claude Desktop (stdio モード)

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "mysql-mcp-webui"],
      "env": {
        "TRANSPORT": "stdio",
        "AUTH_TOKEN": "your-token",
        "MCP_RESPONSE_FORMAT": "toon"
      }
    }
  }
}

Claude Code / HTTP モード（クライアントごとにヘッダーを使用）

{
  "mcpServers": {
    "mysql-web": {
      "type": "http",
      "url": "https://your-server-url.com/mcp",
      "headers": {
        "Authorization": "Bearer your-token",
        "X-Response-Format": "toon"
      }
    }
  }
}

Docker/HTTP モード（サーバー全体で環境変数を使用）

docker run -d \
  --name mysql-mcp \
  -p 9274:9274 \
  -e TRANSPORT=http \
  -e MCP_RESPONSE_FORMAT=toon \
  mysql-mcp-webui

HTTP モードの優先順位:

1. X-Response-Format ヘッダー（クライアントごと） - 推奨
2. MCP_RESPONSE_FORMAT 環境変数（サーバー全体）
3. デフォルト: json

例の比較: 標準の JSON 応答（冗長）

[
  { "id": 1, "name": "Alice", "email": "alice@example.com" },
  { "id": 2, "name": "Bob", "email": "bob@example.com" }
]

TOON 形式（コンパクト）

[2]{id,name,email}:
 1,Alice,alice@example.com
 2,Bob,bob@example.com

利点:

• ✅ 表形式のデータで約 40% 少ないトークン
• ✅ 構造化データに対する Claude の理解度が向上
• ✅ 明示的な行カウントにより LLM の検証が容易
• ✅ stdio と HTTP モードの両方で動作
• ✅ HTTP モード: X-Response-Format ヘッダーを介したクライアントごとの構成（同じサーバー上の異なる Claude Code インスタンスが異なる形式を使用できます）

注意: TOON はオプションです。デフォルトの JSON 形式はほとんどのユースケースで正常に機能します。

TOON の詳細については、github.com/toon-format/toon を参照してください。

Web UI の機能

http://localhost:9274 で管理インターフェースにアクセスできます。

• ダッシュボード - 接続とアクティビティの概要
• 接続 - MySQL サーバー接続を管理し、有効/無効を切り替える
• データベース - 権限を構成し、データベースを有効/無効にし、カスタム別名を管理する
• ブラウザ - テーブルを探索し、データを表示し、インデックスを確認する
• クエリエディタ - 構文ハイライト付きで SQL クエリをテストする
• API キー - 認証トークンを管理する
• ユーザー - マルチユーザーアクセス制御
• ログ - すべての MCP ツール呼び出しの監査トレイル
• ダークモード - システム設定に応じて自動切り替え

v0.1.0 の新機能

• データベース別名 - データベースにカスタムの使いやすい名前を付ける
• 接続コントロール - 接続を有効/無効にして、アクティブな接続を制御する
• add_connection ツール - Claude がプログラムで MySQL 接続を追加できるようになりました

セキュリティ

組み込みの保護機能

✅ 権限検証 - すべてのクエリはデータベースの権限に基づいて検証されます。 ✅ SQL 解析 - 実行前にクエリの種類を検証します。 ✅ トランザクションセーフティ - エラー時に自動ロールバックします。 ✅ パスワード暗号化 - MySQL パスワードに AES-256-GCM を使用します。 ✅ API キー認証 - トークンベースのアクセス制御です。 ✅ リクエストロギング - 完全な監査トレイルを残します。 ✅ レート制限 - 悪用を防止します。 ✅ 入力サニタイズ - SQL インジェクションを防止します。

ベストプラクティス

1. 最初は本番データベースに読み取り専用権限を使用します。
2. 制限された権限を持つ専用の MySQL ユーザーを作成します。
3. Web UI を介して定期的に API キーをローテーションします。
4. 監査ログを確認して、Claude のデータベースアクセスを監視します。
5. 必要なデータベースのみを有効にし、それ以外は無効にします。
6. リモートアクセスの場合は、本番環境で HTTPS を有効にします。

マルチインスタンスサポート

複数の Claude Desktop インスタンスまたはセッションを安全に実行できます。

• stdio モード: 各 Claude Desktop インスタンスは独自のプロセスを取得します。
• HTTP モード: 分離された状態で複数のセッションをサポートします。
• 同時アクセス: WAL モードで安全な SQLite 書き込みを行います。
• セッションクリーンアップ: 非アクティブなセッションを自動的にクリーンアップします（30 分）。

Web UI でデフォルト接続を設定すると、すべての新しいインスタンスが同じ設定で起動します。

トラブルシューティング

MCP サーバーが AUTH_TOKEN エラーで起動しない場合

症状: Claude Desktop のログに "AUTH_TOKEN environment variable is required" または "Invalid AUTH_TOKEN provided" が表示されます。

解決策:

1. 新しいトークンを生成します（まだ生成していない場合）:

   mysql-mcp-webui --generate-token
   

2. 生成されたトークンを出力からコピーします。
3. Claude Desktop の設定ファイルを新しいトークンで更新します:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. JSON 構文が正しいことを確認します（余分なスペース、引用符、またはコンマは不要）。
5. Claude Desktop を完全に再起動します（終了してから再開）。

注意: Claude Desktop を起動する前にトークンを生成する必要があります。

Claude が MCP サーバーに接続できない場合

1. Claude Desktop の設定ファイルの構文を確認します（有効な JSON であること）。
2. 必要に応じて新しい API キーを生成します: mysql-mcp-webui --generate-token
3. トークンが設定ファイルに正しく貼り付けられていることを確認します。
4. Claude Desktop を完全に再起動します（終了してから再開、単なる再読み込みではない）。
5. Web UI が http://localhost:9274 でアクセス可能であることを確認します。

権限拒否エラー

1. Web UI → データベースを開きます。
2. データベースに必要な権限が有効になっていることを確認します。
3. データベースが有効になっていることを確認します（無効になっていないこと）。
4. MySQL ユーザーが実際のデータベース権限を持っていることを確認します。

接続エラー

1. Web UI で接続をテストします（接続ページ → テストボタン）。
2. MySQL サーバーが実行中でアクセス可能であることを確認します。
3. ファイアウォールルールを確認します。
4. MySQL の資格情報が正しいことを確認します。

ポートがすでに使用されている場合

# デフォルトポートを変更する
HTTP_PORT=3001 mysql-mcp-webui

高度な使用方法

カスタムインストールパス

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["/path/to/mysql-mcp-webui/server/dist/index.js"],
      "env": {
        "TRANSPORT": "stdio",
        "AUTH_TOKEN": "your-key"
      }
    }
  }
}

本番デプロイ

Docker デプロイ、HTTPS/TLS 構成、レート制限設定、マルチインスタンスアーキテクチャ、セキュリティ強化については、DEPLOYMENT.md を参照してください。

開発

アーキテクチャの詳細、API ドキュメント、開発セットアップ、コントリビューションガイドラインについては、README_DEVELOPMENT.md を参照してください。

CLI コマンド

# ヘルプを表示
mysql-mcp-webui --help

# 新しい API トークンを生成
mysql-mcp-webui --generate-token

# バージョンを表示
mysql-mcp-webui --version

v0.1.4 の新機能

• 📦 公式 TOON ライブラリ - 適切なネストされたデータ処理のために公式の @toon-format/toon ライブラリを統合しました。
• 🏗️ より良いネスト構造 - ネストされたオブジェクトと配列の適切なインデントベースのエンコーディング。
• 🔄 スマートなフォーマット - 最適な表現のための自動フォーマット検出（表形式、リスト、またはインライン）。
• ⚡ 効率の向上 - 複雑な MySQL JSON カラムデータのトークン最適化を改善しました。
• 🎯 ドットキー折りたたみ - 単一キーチェーンのコンパクトな表現（例: config.db.host: localhost）。
• 🛠️ メンテナンスされたライブラリ - 公式ライブラリにより、仕様の遵守と更新が継続的に保証されます。

以前の更新内容

v0.1.0

• 🔧 新しい MCP ツール: add_connection - Claude がプログラムで MySQL 接続を作成できるようになりました。
• 🏷️ データベース別名 - データベースにカスタムの使いやすい名前を付けることができるようになりました。
• 🎛️ 接続管理 - 接続を有効/無効にして、アクティブな接続を制御できるようになりました。

v0.0.7

• 📖 強化されたドキュメント - MCP ワークフローの例を含む、ユーザー中心の新しい README。
• 🔄 ドキュメントの再編成 - 技術的な詳細は README_DEVELOPMENT.md に移動しました。

リソース

• ドキュメント: GitHub リポジトリ
• 問題とサポート: GitHub Issues
• Model Context Protocol: modelcontextprotocol.io
• 開発ガイド: README_DEVELOPMENT.md
• デプロイガイド: DEPLOYMENT.md
• 変更履歴: CHANGELOG.md

📄 ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください。

謝辞

• Model Context Protocol を使用して構築されています。
• Claude Desktop と Claude Code をサポートしています。
• Yash Agarwal によって作成されました。

---

Claude にデータベースへのアクセスを許可しますか？ 今すぐインストールして、自然言語でデータを探索し始めましょう！ 🚀