MySQL MCP Server

MySQL MCP Server

site icon
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

调试方式

  1. 启动服务器
npx @kevinwatt/mysql-mcp
  1. 使用 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"
      }
    }
  }
}
  1. 保存配置并安装 MCP 服务器

许可证

该项目遵循 MIT 开源许可条款。