一、技术背景与准备工作

1.1 技术背景介绍

MCP(Model Context Protocol)是一种标准化协议，它允许AI工具(如Cursor)通过自然语言直接操作数据库。MySQL MCP服务器作为中间件，实现了Cursor与MySQL数据库的安全交互，开发者无需编写SQL语句即可完成数据库操作712。

1.2 环境准备

在开始配置前，请确保已安装以下工具：

• ‌Cursor IDE‌：最新版本(支持MCP协议)
• ‌Node.js‌：版本≥16(用于运行MCP服务)
• ‌MySQL数据库‌：版本5.7+，建议8.0+
• ‌MCP MySQL服务器‌：可通过npm或Docker安装79

二、MCP MySQL服务器安装与配置

2.1 安装方式

方法1：通过Smithery安装(推荐)

bashCopy Code

npx -y @smithery/cli install @fhuang/mcp-mysql-server --client claude

方法2：手动安装

bashCopy Code

mkdir mcp-mysql-server && cd mcp-mysql-server npm init -y npm install @fhuang/mcp-mysql-server

2.2 配置参数

MCP MySQL服务器支持三种配置方式：

方式1：使用MySQL连接URL(推荐)

bashCopy Code

npx @fhuang/mcp-mysql-server mysql://user:password@localhost:3306/database

方式2：使用环境变量

创建.env文件：

textCopy Code

MYSQL_HOST=localhost MYSQL_USER=your_username MYSQL_PASSWORD=your_password MYSQL_DATABASE=your_database MYSQL_PORT=3306 CONNECTION_LIMIT=10 QUEUE_LIMIT=0

然后启动服务：

bashCopy Code

npx @fhuang/mcp-mysql-server

方式3：在MCP客户端中配置

jsonCopy Code

{ "mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@fhuang/mcp-mysql-server"], "env": { "MYSQL_HOST": "localhost", "MYSQL_USER": "your_username", "MYSQL_PASSWORD": "your_password", "MYSQL_DATABASE": "your_database" } } } }

三、Cursor IDE集成配置

3.1 添加MCP服务器配置

在Cursor中打开设置 → MCP服务器 → 添加新服务器，填写以下配置(示例)：

jsonCopy Code

{ "mcpServers": { "mysql": { "command": "npx", "args": ["-y", "@fhuang/mcp-mysql-server"], "env": { "MYSQL_HOST": "localhost", "MYSQL_USER": "your_username", "MYSQL_PASSWORD": "your_password", "MYSQL_DATABASE": "your_database" } } } }

3.2 验证连接

配置完成后，在Cursor中执行以下操作验证连接：

1. 输入自然语言指令如"列出所有数据库"
2. 观察是否返回预期的数据库列表
3. 尝试执行简单查询如"查询users表的前5行数据"

四、常见问题与解决方案

4.1 连接失败问题

• ‌错误现象‌：Can't connect to MySQL server on 'host'
• ‌解决方案‌：
  1. 检查MySQL服务是否运行
  2. 确认防火墙已开放3306端口
  3. 验证连接参数是否正确2024

4.2 权限不足问题

• ‌错误现象‌：Access denied for user
• ‌解决方案‌：
  1. 创建专用数据库用户
  2. 授予必要权限(如SELECT,INSERT)
  3. 避免使用root账户连接922

4.3 初始化时序问题

• ‌错误现象‌：Received request before initialization was complete
• ‌解决方案‌：
  1. 确保服务完全启动后再发送请求
  2. 实现客户端重连机制
  3. 升级到最新版本22

五、最佳实践与安全建议

5.1 安全配置建议

1. ‌专用用户‌：创建仅用于MCP连接的数据库用户
2. ‌最小权限‌：仅授予必要的SELECT/INSERT权限
3. ‌定期轮换‌：定期更改数据库密码
4. ‌环境变量‌：使用环境变量管理敏感信息912

5.2 性能优化建议

1. ‌连接池‌：合理设置连接池大小(核心数2-4倍)
2. ‌查询优化‌：避免全表扫描，使用索引
3. ‌批量操作‌：减少单次查询数据量
4. ‌监控‌：定期检查连接数和资源使用情况2830

六、实战案例演示

6.1 创建数据库和表

在Cursor中输入：
"创建一个名为test_db的数据库，并在其中创建products表，包含id(主键)、name和price字段"

6.2 数据操作

• 插入数据："向products表插入3条测试数据"
• 查询数据："查询price大于1000的产品"
• 更新数据："将name为'Laptop'的产品价格更新为1299.99"

6.3 模式探索

"列出test_db中的所有表"
"显示products表的字段信息"

七、总结与进阶建议

1. ‌版本管理‌：保持Cursor和MCP服务器为最新版本
2. ‌日志记录‌：启用详细日志便于问题排查
3. ‌备份策略‌：定期备份重要数据库
4. ‌多环境配置‌：为开发/生产环境使用不同配置
5. ‌扩展学习‌：探索MCP对其他数据库(如PostgreSQL)的支持