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

概述

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

前置条件

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

配置步骤

1. 安装MCP MySQL服务器包

bash 复制代码

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

2. 配置MCP服务器

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

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

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服务器配置：

bash 复制代码

npm install -g @modelcontextprotocol/inspector

4. 测试MCP服务器

使用MCP Inspector测试配置：

bash 复制代码

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窗口中使用以下语法：

sql 复制代码

@mysql-local 执行: SQL语句

常用操作示例

1. 测试连接

sql 复制代码

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

2. 查询数据

sql 复制代码

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

3. 查看表结构

sql 复制代码

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

4. 统计查询

sql 复制代码

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

5. 条件查询

sql 复制代码

@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. 权限问题

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

调试步骤

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

安全注意事项

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

替代方案

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

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

总结

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

参考资源

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