Mysql MCP Server

🚀 MySQL MCP 服務器

MySQL MCP 服務器用於與 MySQL 數據庫進行交互。它支持執行只讀查詢（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 參數。

💻 使用示例

基礎用法

1. 執行只讀查詢

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

響應：

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

2. 測試查詢執行

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

響應：

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

3. 列出表

{
  "type": "list_tables"
}

響應：

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

4. 描述表結構

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

響應：

{
  "success": true,
  "data": [
    {
      "Field": "id",
      "Type": "int(11)",
      "Null": "NO",
      "Key": "PRI",
      "Default": null,
      "Extra": ""
    },
    {
      "Field": "name",
      // 原文檔此處未結束，推測後續內容也應按原樣保留
    }
  ]
}