
MySQL MCP Server

2025.02.25
4
JavaScript数据库中间件MySQL 访问数据库
MySQL MCP Server 是一个与 MySQL 数据库集成的 MCP 服务器实现,为大型语言模型(LLMs)提供安全的数据库访问能力。它支持读取和写入操作,包括执行 SELECT 查询、列出数据库表、显示表结构、执行 INSERT/UPDATE/DELETE 操作等。此外,它还提供了安全特性,如只读事务模式、查询长度和结果大小限制、性能监控和日志记录等。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server 是一个为 LLMs 提供 MySQL 数据库访问能力的中间件服务。
核心功能
- 读取操作
- 执行只读 SELECT 查询
- 列出所有数据库表
- 显示表结构
- 查看模式信息
- 写入操作
- 支持事务的 INSERT/UPDATE/DELETE 操作
- 参数化查询以确保数据安全
- 返回受影响的行数和插入 ID
- 安全特性
- 只读事务模式用于 SELECT 查询
- 查询长度和结果大小限制
- 性能监控和日志记录
- 自动事务处理
适用场景
- 需要通过 LLMs 访问 MySQL 数据库的应用
- 需要安全执行数据库查询和修改的场景
- 需要监控和限制数据库操作的场景
工具列表
- mysql_query
- 执行只读 SELECT 查询
- 输入:
sql
(字符串):要执行的 SQL SELECT 查询 - 限制:最大查询长度 4096 字符,最大结果行数 1000,查询超时 30 秒
- mysql_execute
- 执行数据修改操作
- 输入:
sql
(字符串):SQL 语句(INSERT/UPDATE/DELETE),params
(数组,可选):SQL 语句的参数 - 特性:返回受影响的行数,返回最后插入的 ID,自动事务处理
- list_tables
- 列出当前数据库中的所有表
- 无需输入
- describe_table
- 显示表结构
- 输入:
table
(字符串):要描述的表名
常见问题解答
- 如何启动服务器?
- 使用命令
npx @kevinwatt/mysql-mcp
手动启动 - 需要哪些前置依赖?
- Node.js 18+ 和 MySQL Server
使用教程
使用依赖
- 安装 Node.js 18+ 和 MySQL Server
安装教程
npm install -g @kevinwatt/mysql-mcp
调试方式
- 启动服务器
npx @kevinwatt/mysql-mcp
- 使用 Dive Desktop 配置 MCP 服务器
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": [
"-y",
"@kevinwatt/mysql-mcp"
],
"env": {
"MYSQL_HOST": "127.0.0.1",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "",
"MYSQL_DB": "your_database"
}
}
}
}
- 保存配置并安装 MCP 服务器