概述

本指南将详细介绍如何在Cursor中配置MCP（Model Context Protocol）MySQL服务器，实现直接在chat窗口中执行SQL查询的功能。

前置条件

• Cursor IDE（支持MCP的版本）
• Node.js环境
• MySQL数据库访问权限
• Windows 11操作系统

配置步骤

1. 安装MCP MySQL服务器包

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

2. 配置MCP服务器

在Cursor的MCP配置文件中添加以下配置：

文件位置：c:\Users\{用户名}\.cursor\mcp.json

{
  "mcpServers": {
    "mysql-local": {
      "command": "npx",
      "args": [
        "@f4ww4z/mcp-mysql-server",
        "--host", "127.0.0.1",
        "--port", "3307",
        "--user", "root",
        "--password", "111111"
      ]
    }
  }
}

3. 安装MCP Inspector（可选）

用于测试MCP服务器配置：

npm install -g @modelcontextprotocol/inspector

4. 测试MCP服务器

使用MCP Inspector测试配置：

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

访问：http://localhost:6274 进行测试

5. 重启Cursor

• 完全关闭Cursor
• 重新打开Cursor
• 重新打开项目

使用方法

基本语法

在Cursor的chat窗口中使用以下语法：

@mysql-local 执行: SQL语句

常用操作示例

1. 测试连接

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

2. 查询数据

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

3. 查看表结构

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

4. 统计查询

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

5. 条件查询

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

可用的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 - 查看表结构

故障排除

常见问题

1. MCP工具不可用

• 确保完全重启了Cursor
• 检查MCP配置文件格式是否正确
• 验证MCP服务器包是否正确安装

2. 连接失败

• 检查数据库连接参数（主机、端口、用户名、密码）
• 确认数据库服务是否运行
• 验证网络连接

3. 权限问题

• 确保数据库用户有足够的权限
• 检查数据库防火墙设置

调试步骤

1. 使用MCP Inspector测试服务器
2. 检查Cursor的开发者工具控制台
3. 查看MCP服务器日志

安全注意事项

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

替代方案

如果MCP配置遇到问题，可以使用：

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

总结

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

参考资源

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

---

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