MySQL MCP配置与使用教程
io.mcp-cn.benborla29/mcp-server-mysql
MySQL数据库的MCP服务器,支持数据库操作和管理
建议先在本页复制安装配置,再到上游核对文档与权限。
热度数据
产品介绍
MySQL数据库的MCP服务器,支持数据库操作和管理 MySQL 是一个MCP Server,收录自 MCP Hub 中国。支持 stdio 传输。本页提供产品介绍、配置教程、安装命令与适用场景,支持 Trae、通义灵码、Cursor、Claude Code、VS Code 等。
适用场景
AgentHub Verified 可用性验证技术测试通过
自动化测试流水线已校验安装命令、传输协议与客户端兼容性
按平台快速复制
选择你的平台查看安装方式
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
预填环境变量与密钥(可选)
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}配置教程
- 打开 MySQL 详情页,确认这是你需要的 MCP Server(来源 MCP Hub 中国)。
- 按客户端选择 Trae、通义灵码、Cursor、Claude Code 或 VS Code,复制 JSON 配置或 CLI 命令。
- 将配置合并进 mcpServers,并把环境变量占位符替换为真实密钥。
- 重载窗口后,在 Agent 对话中调用该 MCP 提供的工具。
安装命令
以下安装命令与配置步骤已写入页面 HTML,搜索引擎与未启用 JavaScript 的浏览器均可直接读取。
Claude Code(本地)
- 确保已安装 Claude Code CLI
- 复制下方命令,将 <占位符> 替换为真实环境变量值后,在终端执行
- 若下方列出了环境变量,请对照填写
claude mcp add mcp-server-mysql --env MYSQL_HOST=<MYSQL_HOST> --env MYSQL_PORT=<MYSQL_PORT> --env MYSQL_USER=<MYSQL_USER> --env MYSQL_PASS=<MYSQL_PASS> --env MYSQL_DB=<MYSQL_DB> --env ALLOW_INSERT_OPERATION=<ALLOW_INSERT_OPERATION> --env ALLOW_UPDATE_OPERATION=<ALLOW_UPDATE_OPERATION> --env ALLOW_DELETE_OPERATION=<ALLOW_DELETE_OPERATION> --env PATH=<PATH> --env NODE_PATH=<NODE_PATH> -- npx -y @benborla29/mcp-server-mysqlCursor — .cursor/mcp.json(本地)
- 打开项目根目录下的 .cursor/mcp.json(没有就新建)
- 点击「复制配置」粘贴进去;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后按 Cmd+Shift+P(Windows:Ctrl+Shift+P)→ 输入 Reload Window 并执行
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}VS Code — .vscode/mcp.json(本地)
- 确保 VS Code 已安装 GitHub Copilot 扩展并支持 MCP
- 打开项目根目录下的 .vscode/mcp.json(没有就新建)
- 点击「复制配置」粘贴;若已有其他 MCP,只合并 mcpServers 里的本条目
- 将 env 中的 <占位符> 替换为真实密钥(见下方「环境变量」)
- 保存后重新加载 VS Code 窗口
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Claude Desktop — claude_desktop_config.json(本地)
- 打开 Claude Desktop 的 claude_desktop_config.json(路径见远程指引)
- 点击「复制配置」合并到 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥
- 完全退出并重启 Claude Desktop
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Trae — .trae/mcp.json(本地)
- 打开 Trae → 设置 → MCP,或编辑 .trae/mcp.json / 全局 mcp.json
- 点击「复制配置」粘贴并合并 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥
- 保存后重载 Trae 窗口
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Cherry Studio — MCP 设置(本地)
- 打开 Cherry Studio → 设置 → MCP 服务器 → 添加(STDIO)
- 也可直接导入下方 JSON:点击「复制配置」合并到 mcpServers
- 将 env 中的 <占位符> 替换为真实密钥,并确保本机已安装 Node.js / uv(npx、uvx)
- 启用服务并查看工具列表是否加载成功
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}通义灵码 — MCP 配置(本地)
- 通义灵码:个人设置 → MCP 服务 → 「+」→ 手工添加(STDIO)或配置文件添加
- 点击「复制配置」合并 mcpServers;命令/参数/环境变量与 JSON 一致
- 将 env 中的 <占位符> 替换为真实密钥;本机需 Node.js 18+(npx)或已安装 uv(uvx)
- 确认服务状态为已连接后再在智能体对话中调用
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Windsurf — mcp_config.json(本地)
- 编辑 ~/.codeium/windsurf/mcp_config.json
- 点击「复制配置」合并 mcpServers(本地 stdio 与 Cursor 格式相同)
- 将 env 中的 <占位符> 替换为真实密钥后保存并刷新 Cascade
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}Cline — MCP Servers(本地)
- Cline 面板 → 设置 → MCP Servers
- 点击「复制配置」粘贴并合并
- 将 env 中的 <占位符> 替换为真实密钥后保存
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}WorkBuddy — .workbuddy/mcp.json(本地)
- 编辑 ~/.workbuddy/mcp.json(用户级)或项目目录 .workbuddy/mcp.json
- 也可在界面:插件 → MCP 服务器 → 配置 MCP,粘贴下方 JSON
- 将 env 中的 <占位符> 替换为真实密钥;Windows 下 command/脚本路径建议用绝对路径
- 保存并重启 WorkBuddy,确认连接器状态为绿色
{
"mcpServers": {
"mcp-server-mysql": {
"command": "npx",
"args": [
"-y",
"@benborla29/mcp-server-mysql"
],
"env": {
"MYSQL_HOST": "<MYSQL_HOST>",
"MYSQL_PORT": "<MYSQL_PORT>",
"MYSQL_USER": "<MYSQL_USER>",
"MYSQL_PASS": "<MYSQL_PASS>",
"MYSQL_DB": "<MYSQL_DB>",
"ALLOW_INSERT_OPERATION": "<ALLOW_INSERT_OPERATION>",
"ALLOW_UPDATE_OPERATION": "<ALLOW_UPDATE_OPERATION>",
"ALLOW_DELETE_OPERATION": "<ALLOW_DELETE_OPERATION>",
"PATH": "<PATH>",
"NODE_PATH": "<NODE_PATH>"
}
}
}
}常见报错排查与运行避坑 (Troubleshooting)FAQ
针对 MySQL 在 Cursor、Claude Code 中的常见连接错误与解决办法
在 Cursor / Claude Code 中配置 MySQL 提示 connection closed 或 exit code 1?
通常由本地运行时环境缺失或命令路径未被 IDE 继承引起。排查步骤: 1. 确认已安装 Node.js 18+(支持 npx)或 Python 3.10+(支持 uvx); 2. 尝试在终端运行 which npx 或 which uvx,把配置文件中的 "command" 字段改为完整绝对路径; 3. 修改 mcp.json 后,必须完全重载或重启客户端窗口。
# 终端测试命令是否存在: which npx node -v
提示 spawn npx ENOENT 或 command not found?
这是因为编辑器后台进程未加载完整的终端环境变量(PATH)。解决方案:在全局安装该包(如 npm install -g 包名),或在配置文件中将 command 设置为系统的实际路径(如 Windows 下的 C:\Program Files\nodejs\npx.cmd,Mac 下的 /usr/local/bin/npx)。
提示 Missing required environment variable 或 API 认证失败?
MySQL 依赖环境变量(如 MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASS、MYSQL_DB、ALLOW_INSERT_OPERATION、ALLOW_UPDATE_OPERATION、ALLOW_DELETE_OPERATION、PATH、NODE_PATH)。请在客户端配置文件的 "env" 对象中填入有效密钥,注意不要包含多余空格或未闭合的双引号。
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"MYSQL_HOST": "your_actual_key_here"
}
}免安装模拟调用 (Playground)
仿真环境MySQL 数据库查询与结构仿真 · 无需配置本地环境,直接预览调用参数与返回格式
{
"query": "SELECT id, name, status, created_at FROM records WHERE status = 'active' LIMIT 3;"
}点击上方「模拟运行」按钮
查看该工具在 Agent 内部的返回数据格式
选型与决策建议(为什么选它?)
帮助你快速判断该资源是否契合当前项目,避免盲目折腾
- 开发环境数据探查
- 生成只读分析 SQL
- Schema 文档化
- 生产库无限制的写操作
- 未脱敏的敏感表直接暴露给 AI
Postgres MCP + SQL 分析 Skill → 对话式 BI
MCP 实战教程:从安装到看见效果
按完整实例走一遍(含期望效果与对比验收)。装完本页资源后,用教程里的提示词核对是否真正生效。
相关资源
Context7
io.mcp-cn.upstash/context7-mcp
基于Upstash的向量搜索和上下文管理MCP服务
顺序思考
io.mcp-cn.modelcontextprotocol/server-sequential-thinking
帮助AI进行结构化思考和推理的MCP工具
n8n
io.mcp-cn.drballs/n8n-mcp-server
n8n工作流自动化平台的MCP服务器,提供完整的工作流管理、执行控制、凭证管理等功能
Playwright
io.mcp-cn.playwright/mcp
基于Playwright的自动化测试和网页操作MCP工具
GitHub
io.mcp-cn.modelcontextprotocol/server-github
连接GitHub的MCP服务器,支持仓库管理、问题跟踪、代码搜索等功能
高德地图
io.mcp-cn.amap/amap-maps-mcp-server
高德地图的MCP服务器
常搭配使用
CloudBase 腾讯云开发
v1.92.120
io.clawhub.binggg/cloudbase
当你开发、设计、构建、部署、调试、迁移或排查 CloudBase(腾讯云开发、云开发、TCB、微信云开发)项目时使用此技能——覆盖 Web、微信小程序、小程序、uni-app、移动端(iOS、Android、Flutter、React Native)。涵盖:UI(页面、界面、表单、dashboard、原型);认证(登录、注册、OAuth、publishable key);数据库(NoSQL 文档数据库、MySQL 关系型数据库、PostgreSQL/CloudBase PG、app.rdb()、queryPgDatabase/managePgDatabase、CRUD、安全规则);云函数(serverless、scf_bootstrap);CloudRun(云托管、Dockerfile);云存储;内置 AI(内置大模型、AI 对话、流式输出、图片生成、generateText、streamText、createModel、generateImage、TokenHub、混元、DeepSeek、GLM、Kimi、Token Credits 资源包、小程序成长计划);第三方/自定义大模型接入(大模型调用、LLM API);AI 智能体(智能体、AG-UI、LangGraph);运维巡检(巡检、诊断、日志);规格工作流(需求文档、技术方案、requirements、tasks.md)。不适用于非 CloudBase 项目、不含 CloudBase 的纯前端或不含 CloudBase 的自托管后端。
WP Multitool — WordPress 优化工具箱
v1.9.9
io.clawhub.marcindudekdev/wp-multi-tool
WordPress 站点健康审计、性能优化、数据库清理、autoload 调优、慢查询检测、wp-config 管理、图片尺寸控制、前端提速修复与服务器诊断。19 个优化与控制模块整合为单一付费插件(Pro 版单站 $79/年,$199/年或 $499 买断无限站点)。本技能中的诊断命令无需插件即可在任意 WordPress 5.8+ 站点运行。
Ach Publish
v3.0.25
io.clawhub.liuboacean/agent-comm-hub
本地多智能体通信 Hub(MCP stdio / HTTP-SSE),提供消息、任务编排、共享记忆、进化引擎,暴露 58 个 MCP 工具 + Web 管理面板
PlanetScale CLI Skills
v1.0.31
io.clawhub.vince-winkintel/planetscale-cli-skills
PlanetScale CLI command reference and workflows. Use for authentication; org, SSO, teams, and billing; databases, branches, Neki, internal or external keyspaces, logs, maintenance, extensions, metrics, insights, inspect, and SQL; deploy requests, schema migrations, MoveTables, throttlers, rollout concurrency, disk-storage settings, and Traffic Control; PgBouncers, read-only replicas, roles, passwords, backups, webhooks, audit logs, service tokens, D1 imports, and automation. Routes to focused pscale sub-skills. Triggers on PlanetScale CLI, pscale, pscale --skill, database, branch, Neki, keyspace, create-external, external keyspace, deploy request, move-tables, vtctl, vtctld, max rollout, disk scaling, max storage, throttler, traffic-control, metrics, insights, inspect, SQL, role, password, pgbouncer, read-only replica, backup, webhook, audit-log, billing, org, SSO, service token, import d1.
继续逛 AgentHub
大多数人安装前还会对比同类工具或看场景方案——下面这些能帮你少走弯路。
收录徽章:把 AgentHub 挂到你的官网
复制下面任意一段代码到项目主页、官网或 GitHub README。徽章是 SVG 热链,无需上传文件,链接指向本页,访客可由此直接找到安装方式。
<a href="https://myagenthub.cn/p/io.mcp-cn.benborla29/mcp-server-mysql" title="AgentHub 已收录:MySQL" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.mcp-cn.benborla29/mcp-server-mysql" alt="AgentHub 已收录:MySQL" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.mcp-cn.benborla29/mcp-server-mysql)徽章由 /badge/<资源ID> 动态生成,名称与收录状态变化后自动更新;请保留链接指向,它是收录来源的判定依据。
统一 Manifest
{
"id": "io.mcp-cn.benborla29/mcp-server-mysql",
"type": "mcp-server",
"version": "latest",
"displayName": "MySQL",
"description": "MySQL数据库的MCP服务器,支持数据库操作和管理",
"author": {
"name": "Ben Borla"
},
"iconUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTFPLXqRyw5PEl4ETnuzYuP5XhUI51sUdQzcg&s",
"homepage": "https://mcp-cn.com/server/90",
"distribution": {
"packages": [
{
"registryType": "npm",
"identifier": "@benborla29/mcp-server-mysql",
"runtimeHint": "npx",
"transport": "stdio",
"environmentVariables": [
{
"name": "MYSQL_HOST",
"description": "<YOUR_MYSQL_HOST>",
"isRequired": true,
"isSecret": false
},
{
"name": "MYSQL_PORT",
"description": "3306",
"isRequired": true,
"isSecret": false
},
{
"name": "MYSQL_USER",
"description": "<YOUR_MYSQL_USER>",
"isRequired": true,
"isSecret": false
},
{
"name": "MYSQL_PASS",
"description": "<YOUR_MYSQL_PASSWORD>",
"isRequired": true,
"isSecret": false
},
{
"name": "MYSQL_DB",
"description": "<YOUR_MYSQL_DATABASE>",
"isRequired": true,
"isSecret": false
},
{
"name": "ALLOW_INSERT_OPERATION",
"description": "false",
"isRequired": true,
"isSecret": false
},
{
"name": "ALLOW_UPDATE_OPERATION",
"description": "false",
"isRequired": true,
"isSecret": false
},
{
"name": "ALLOW_DELETE_OPERATION",
"description": "false",
"isRequired": true,
"isSecret": false
},
{
"name": "PATH",
"description": "<YOUR_PATH>",
"isRequired": true,
"isSecret": false
},
{
"name": "NODE_PATH",
"description": "<YOUR_NODE_PATH>",
"isRequired": true,
"isSecret": false
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [
"use_count:45972",
"数据库",
"MySQL",
"数据管理",
"SQL"
],
"provenance": {
"origin": "mcp-cn",
"originalId": "@benborla29/mcp-server-mysql",
"originalUrl": "https://mcp-cn.com/server/90",
"isOfficial": false,
"status": "active"
}
}