Mysql MCP Server

🚀 MySQL MCP サーバー

MySQL データベースとのインタラクションに使用する MCP サーバーです。

このサーバーは、読み取り専用クエリ（query）と最終的にロールバックされる書き込みクエリ（test_execute）の実行をサポートしています。

🚀 クイックスタート

📦 環境構成

環境変数

以下の環境変数を ~/.mcp/.env ファイルに追加してください：

MYSQL_HOST=host.docker.internal  # ホストサービスにアクセスするための hostname
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password

⚠️ 重要提示

host.docker.internal は Docker コンテナがホストサービスにアクセスするための特殊な DNS 名です。MySQL サーバーがホストマシン上で実行されている場合は、この設定を使用してください。他の MySQL サーバーに接続する場合は、適切な hostname に置き換えてください。

mcp.json 設定

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--add-host=host.docker.internal:host-gateway",
        "--env-file",
        "/Users/username/.mcp/.env",
        "ghcr.io/xiangma9712/mcp/mysql"
      ]
    }
  }
}

💻 使用例

サーバーの起動

docker run -i --rm --add-host=host.docker.internal:host-gateway --env-file ~/.mcp/.env ghcr.io/xiangma9712/mcp/mysql

⚠️ 重要提示

OrbStack を使用している場合、host.docker.internal は自動的にサポートされるため、--add-host パラメータを省略できます。Docker Desktop でも通常は自動的にこの設定がサポートされますが、より高い信頼性のために --add-host パラメータの追加をおすすめします。

利用可能なコマンド

基本的な使用法

• 読み取り専用クエリの実行

{
  "type": "query",
  "payload": {
    "sql": "SELECT * FROM your_table"
  }
}

応答：

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "example"
    }
  ]
}

高度な使用法

• クエリ実行のテスト

{
  "type": "test_execute",
  "payload": {
    "sql": "UPDATE your_table SET name = 'updated' WHERE id = 1"
  }
}

応答：

{
  "success": true,
  "data": "The UPDATE SQL query can be executed."
}

• テーブルの一覧表示

{
  "type": "list_tables"
}

応答：

{
  "success": true,
  "data": ["table1", "table2", "table3"]
}

• テーブル構造の説明

{
  "type": "describe_table",
  "payload": {
    "table": "your_table"
  }
}

応答：

{
  "success": true,
  "data": [
    {
      "Field": "id",
      "Type": "int(11)",
      "Null": "NO",
      "Key": "PRI",
      "Default": null,
      "Extra": ""
    },
    {
      "Field": "name",
      // 元の README の続きがあればここに追加
    }
  ]
}