首页 › 后端架构/服务器综合论坛 › Cursor集成MCP MySQL服务器完整配置指南

尧尧爷爷 發表於 2025-9-11 09:09:38

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

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li><a href="#_label0">概述</a></li><li><a href="#_label1">前置条件</a></li><li><a href="#_label2">配置步骤</a></li><ul class="second_class_ul"><li><a href="#_lab2_2_0">1. 安装MCP MySQL服务器包</a></li><li><a href="#_lab2_2_1">2. 配置MCP服务器</a></li><li><a href="#_lab2_2_2">3. 安装MCP Inspector（可选）</a></li><li><a href="#_lab2_2_3">4. 测试MCP服务器</a></li><li><a href="#_lab2_2_4">5. 重启Cursor</a></li></ul><li><a href="#_label3">使用方法</a></li><ul class="second_class_ul"><li><a href="#_lab2_3_5">基本语法</a></li><li><a href="#_lab2_3_6">常用操作示例</a></li><ul class="third_class_ul"><li><a href="#_label3_3_6_0">1. 测试连接</a></li><li><a href="#_label3_3_6_1">2. 查询数据</a></li><li><a href="#_label3_3_6_2">3. 查看表结构</a></li><li><a href="#_label3_3_6_3">4. 统计查询</a></li><li><a href="#_label3_3_6_4">5. 条件查询</a></li></ul></ul><li><a href="#_label4">可用的MCP工具</a></li><ul class="second_class_ul"></ul><li><a href="#_label5">故障排除</a></li><ul class="second_class_ul"><li><a href="#_lab2_5_7">常见问题</a></li><ul class="third_class_ul"><li><a href="#_label3_5_7_5">1. MCP工具不可用</a></li><li><a href="#_label3_5_7_6">2. 连接失败</a></li><li><a href="#_label3_5_7_7">3. 权限问题</a></li></ul><li><a href="#_lab2_5_8">调试步骤</a></li><ul class="third_class_ul"></ul></ul><li><a href="#_label6">安全注意事项</a></li><ul class="second_class_ul"></ul><li><a href="#_label7">替代方案</a></li><ul class="second_class_ul"></ul><li><a href="#_label8">总结</a></li><ul class="second_class_ul"></ul><li><a href="#_label9">参考资源</a></li><ul class="second_class_ul"></ul></ul></div><p class="maodian"><a name="_label0"></a></p><h2>概述</h2>
<p>本指南将详细介绍如何在Cursor中配置MCP（Model Context Protocol）MySQL服务器，实现直接在chat窗口中执行SQL查询的功能。</p>
<p class="maodian"><a name="_label1"></a></p><h2>前置条件</h2>
<ul><li>Cursor IDE（支持MCP的版本）</li><li>Node.js环境</li><li>MySQL数据库访问权限</li><li>Windows 11操作系统</li></ul>
<p class="maodian"><a name="_label2"></a></p><h2>配置步骤</h2>
<p class="maodian"><a name="_lab2_2_0"></a></p><h3>1. 安装MCP MySQL服务器包</h3>
<div class="jb51code"><pre class="brush:bash;"># 安装推荐的MCP MySQL服务器包
npm install -g @f4ww4z/mcp-mysql-server</pre></div>
<p class="maodian"><a name="_lab2_2_1"></a></p><h3>2. 配置MCP服务器</h3>
<p>在Cursor的MCP配置文件中添加以下配置：</p>
<p><strong>文件位置</strong>：<code>c:\Users\{用户名}\.cursor\mcp.json</code></p>
<div class="jb51code"><pre class="brush:json;">{
"mcpServers": {
    "mysql-local": {
      "command": "npx",
      "args": [
      "@f4ww4z/mcp-mysql-server",
      "--host", "127.0.0.1",
      "--port", "3307",
      "--user", "root",
      "--password", "111111"
      ]
    }
}
}</pre></div>
<p class="maodian"><a name="_lab2_2_2"></a></p><h3>3. 安装MCP Inspector（可选）</h3>
<p>用于测试MCP服务器配置：</p>
<div class="jb51code"><pre class="brush:bash;">npm install -g @modelcontextprotocol/inspector</pre></div>
<p class="maodian"><a name="_lab2_2_3"></a></p><h3>4. 测试MCP服务器</h3>
<p>使用MCP Inspector测试配置：</p>
<div class="jb51code"><pre class="brush:bash;">npx @modelcontextprotocol/inspector npx @f4ww4z/mcp-mysql-server --host 127.0.0.1 --port 3307 --user root --password 111111</pre></div>
<p>访问：<code>http://localhost:6274</code> 进行测试</p>
<p class="maodian"><a name="_lab2_2_4"></a></p><h3>5. 重启Cursor</h3>
<ul><li>完全关闭Cursor</li><li>重新打开Cursor</li><li>重新打开项目</li></ul>
<p class="maodian"><a name="_label3"></a></p><h2>使用方法</h2>
<p class="maodian"><a name="_lab2_3_5"></a></p><h3>基本语法</h3>
<p>在Cursor的chat窗口中使用以下语法：</p>
<div class="jb51code"><pre class="brush:bash;">@mysql-local 执行: SQL语句</pre></div>
<p class="maodian"><a name="_lab2_3_6"></a></p><h3>常用操作示例</h3>
<p class="maodian"><a name="_label3_3_6_0"></a></p><h4>1. 测试连接</h4>
<div class="jb51code"><pre class="brush:bash;">@mysql-local 执行: SELECT 1 as test_connection;</pre></div>
<p class="maodian"><a name="_label3_3_6_1"></a></p><h4>2. 查询数据</h4>
<div class="jb51code"><pre class="brush:sql;">@mysql-local 执行: SELECT * FROM xxxx LIMIT 5;</pre></div>
<p class="maodian"><a name="_label3_3_6_2"></a></p><h4>3. 查看表结构</h4>
<div class="jb51code"><pre class="brush:sql;">@mysql-local 执行: SHOW CREATE TABLE xxxx;</pre></div>
<p class="maodian"><a name="_label3_3_6_3"></a></p><h4>4. 统计查询</h4>
<div class="jb51code"><pre class="brush:sql;">@mysql-local 执行: SELECT status, COUNT(*) FROM xxxx GROUP BY status;</pre></div>
<p class="maodian"><a name="_label3_3_6_4"></a></p><h4>5. 条件查询</h4>
<div class="jb51code"><pre class="brush:sql;">@mysql-local 执行: SELECT * FROM xxxx WHERE status = 'approve_success';</pre></div>
<p class="maodian"><a name="_label4"></a></p><h2>可用的MCP工具</h2>
<p>配置成功后，以下工具将自动可用：</p>
<ul><li><code>mcp_mysql-local_connect_db</code> - 连接数据库</li><li><code>mcp_mysql-local_query</code> - 执行SELECT查询</li><li><code>mcp_mysql-local_execute</code> - 执行INSERT/UPDATE/DELETE</li><li><code>mcp_mysql-local_list_tables</code> - 列出所有表</li><li><code>mcp_mysql-local_describe_table</code> - 查看表结构</li></ul>
<p class="maodian"><a name="_label5"></a></p><h2>故障排除</h2>
<p class="maodian"><a name="_lab2_5_7"></a></p><h3>常见问题</h3>
<p class="maodian"><a name="_label3_5_7_5"></a></p><h4>1. MCP工具不可用</h4>
<ul><li>确保完全重启了Cursor</li><li>检查MCP配置文件格式是否正确</li><li>验证MCP服务器包是否正确安装</li></ul>
<p class="maodian"><a name="_label3_5_7_6"></a></p><h4>2. 连接失败</h4>
<ul><li>检查数据库连接参数（主机、端口、用户名、密码）</li><li>确认数据库服务是否运行</li><li>验证网络连接</li></ul>
<p class="maodian"><a name="_label3_5_7_7"></a></p><h4>3. 权限问题</h4>
<ul><li>确保数据库用户有足够的权限</li><li>检查数据库防火墙设置</li></ul>
<p class="maodian"><a name="_lab2_5_8"></a></p><h3>调试步骤</h3>
<ol><li>使用MCP Inspector测试服务器</li><li>检查Cursor的开发者工具控制台</li><li>查看MCP服务器日志</li></ol>
<p class="maodian"><a name="_label6"></a></p><h2>安全注意事项</h2>
<ol><li><strong>密码安全</strong>：不要在配置文件中硬编码密码，考虑使用环境变量</li><li><strong>权限控制</strong>：为MCP服务器创建专用数据库用户，只授予必要权限</li><li><strong>网络安全</strong>：确保数据库连接通过安全网络</li></ol>
<p class="maodian"><a name="_label7"></a></p><h2>替代方案</h2>
<p>如果MCP配置遇到问题，可以使用：</p>
<ol><li><strong>SQLTools插件</strong>：在Cursor中直接执行SQL</li><li><strong>终端命令</strong>：使用MySQL命令行客户端</li><li><strong>其他MCP包</strong>：尝试不同的MCP MySQL服务器包</li></ol>
<p class="maodian"><a name="_label8"></a></p><h2>总结</h2>
<p>通过MCP MySQL服务器，开发者可以在Cursor的chat窗口中直接执行SQL查询，大大提高了数据库操作的效率。配置过程虽然需要一些步骤，但一旦完成，就能享受到AI辅助的数据库操作体验。</p>
<p class="maodian"><a name="_label9"></a></p><h2>参考资源</h2>
<ul><li><a href="https://docs.cursor.com/en/guides/tutorials/building-mcp-server" rel="external nofollow"   target="_blank">Cursor MCP官方文档</a></li><li><a href="https://www.npmjs.com/package/@f4ww4z/mcp-mysql-server" rel="external nofollow"   target="_blank">MCP MySQL服务器包</a></li><li><a href="https://www.npmjs.com/package/@modelcontextprotocol/inspector" rel="external nofollow"   target="_blank">MCP Inspector</a></li></ul>
<p>本文档基于实际配置经验编写，如有问题请参考官方文档或联系技术支持。</p>
<p>到此这篇关于Cursor集成MCP MySQL服务器完整配置指南的文章就介绍到这了,更多相关MCP MySQL服务器配置内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>

查看完整版本: Cursor集成MCP MySQL服务器完整配置指南