Cursor 安装 MySQL MCP 教程（Mac + pipx 全局安装）

本教程基于 GitHub 仓库：
designcomputer/mysql_mcp_server

目标：在 Mac + Cursor 上安装 MySQL MCP Server，让 AI 可以安全访问你的 MySQL 数据库。

---

一、环境准备

1. Python 3.10+

查看 Python 版本：

python3 --version

如果没有或版本过低，安装最新 Python：

brew install python

---

2. 安装 uv（推荐）

用于运行 MCP Server：

pip install uv

或者：

brew install uv

---

3. 安装 pipx（全局工具管理）

pipx 用于在独立虚拟环境中安装 Python CLI 工具，避免破坏系统 Python，推荐全局安装 MCP Server。

brew install pipx

初始化 pipx（确保路径可用）：

pipx ensurepath

---

二、使用 pipx 安装 MySQL MCP Server

使用 pipx 全局安装 MCP Server：

pipx install mysql-mcp-server

安装完成后，系统会自动把可执行文件加入 PATH

✅ 这样就避免了 macOS PEP 668 的 externally-managed-environment 报错，同时 MCP Server 可以全局可用。

---

三、Cursor 配置 MCP

创建或编辑 MCP 配置文件：

~/.cursor/mcp.json

示例配置：

{
  "servers": {
    "mysql": {
      "type": "stdio",
      "command": "mysql_mcp_server",
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "123456",
        "MYSQL_DATABASE": "test"
      }
    }
  }
}

说明：

• MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE 根据你的 MySQL 实际信息修改

• command 填写 pipx 安装后的可执行文件名称 mysql_mcp_server

---

四、重启 Cursor

1. 关闭 Cursor

2. 重新打开

3. MCP Server 会自动加载

---

五、测试 MCP 是否成功

在 Cursor Chat 中输入：

SHOW TABLES;

或者：

列出数据库所有表

如果返回表列表，则安装成功。

---

六、安全建议

不要使用 root 用户，建议创建只读用户：

CREATE USER 'mcp_user'@'localhost' IDENTIFIED BY 'password';
GRANT SELECT ON your_database.* TO 'mcp_user'@'localhost';

这样 AI 只能查询数据，无法修改数据库。