Cursor集成MCP MySQL服务器完整配置指南#

概述#

MCP（Model Context Protocol）是Cursor IDE提供的一种协议，允许AI模型与外部服务进行交互。通过配置MCP MySQL服务器，开发者可以在Cursor的chat界面中直接执行SQL查询、查看表结构、统计数据等操作，无需切换到其他工具，实现无缝的开发体验。

前置条件#

在开始配置之前，请确保你已经满足以下条件：

• Cursor IDE：需要安装支持MCP功能的Cursor版本
• Node.js环境：确保已安装Node.js
• MySQL数据库访问权限：需要有可访问的MySQL数据库
• Windows 11操作系统：本文基于Windows 11环境进行配置

配置步骤#

1
# 安装推荐的MCP MySQL服务器包
2
npm install -g @f4ww4z/mcp-mysql-server

1
{
2
  "mcpServers": {
3
    "mysql-local": {
4
      "command": "npx",
5
      "args": [
6
        "@f4ww4z/mcp-mysql-server",
7
        "--host", "127.0.0.1",
8
        "--port", "3307",
9
        "--user", "root",
10
        "--password", "111111"
11
      ]
12
    }
13
  }
14
}

1
npm install -g @modelcontextprotocol/inspector

1
npx @modelcontextprotocol/inspector npx @f4ww4z/mcp-mysql-server --host 127.0.0.1 --port 3307 --user root --password 111111

使用方法#

1
@mysql-local 执行: SQL语句

1
@mysql-local 执行: SELECT 1 as test_connection;

1
@mysql-local 执行: SELECT * FROM xxxx LIMIT 5;

1
@mysql-local 执行: SHOW CREATE TABLE xxxx;

1
@mysql-local 执行: SELECT status, COUNT(*) FROM xxxx GROUP BY status;

1
@mysql-local 执行: SELECT * FROM xxxx WHERE status = 'approve_success';

可用的MCP工具#

配置成功后，以下MCP工具将自动可用：

• mcp_mysql-local_connect_db：连接数据库
• mcp_mysql-local_query：执行SELECT查询
• mcp_mysql-local_execute：执行INSERT/UPDATE/DELETE操作
• mcp_mysql-local_list_tables：列出所有表
• mcp_mysql-local_describe_table：查看表结构

故障排除#

在使用过程中，可能会遇到一些问题，以下是常见问题及解决方法：

安全注意事项#

在配置和使用MCP MySQL服务器时，请注意以下安全问题：

• 密码安全：不要在配置文件中硬编码密码，考虑使用环境变量
• 权限控制：为MCP服务器创建专用数据库用户，只授予必要权限
• 网络安全：确保数据库连接通过安全网络进行

替代方案#

如果MCP配置遇到问题，可以考虑以下替代方案：

• SQLTools插件：在Cursor中直接执行SQL
• 终端命令：使用MySQL命令行客户端
• 其他MCP包：尝试不同的MCP MySQL服务器包

总结#

通过配置MCP MySQL服务器，开发者可以在Cursor的chat窗口中直接执行SQL查询，大大提高了数据库操作的效率。配置过程虽然需要一些步骤，但一旦完成，就能享受到AI辅助的数据库操作体验，让开发工作更加流畅和高效。

参考资源#

• Cursor MCP官方文档
• MCP MySQL服务器包
• MCP Inspector

本文档基于实际配置经验编写，如有问题请参考官方文档或联系技术支持。