MCP MySQL Server Implementation

一个基于NodeJS的MySQL数据库MCP服务器，允许LLM检查数据库模式和执行SQL查询，支持多数据库模式和细粒度权限控制。

数据库开发者工具 #MySQL连接 #数据库查询 #权限管理 #多数据库 .TypeScript

评分 : 2分

下载量 : 78

更新时间 : 2025-04-29

什么是MySQL MCP服务器？

MySQL MCP服务器是一个允许大型语言模型（LLMs）访问和操作MySQL数据库的工具。它提供数据库模式查看、SQL查询执行以及数据写入（如插入、更新、删除）等功能。

如何使用MySQL MCP服务器？

通过配置环境变量和运行命令，您可以快速设置服务器并与您的数据库连接。支持多种开发工具和平台集成，例如Cursor、Claude Desktop和Smithery。

适用场景

适用于需要让AI直接与MySQL数据库交互的开发者、数据科学家和企业用户。支持复杂查询、多数据库管理及细粒度权限控制。

主要功能

SQL查询执行支持复杂的SQL查询，并返回结果集。

数据库模式查看自动生成表结构和列信息，方便了解数据库架构。

数据写入支持允许执行INSERT、UPDATE和DELETE操作，需手动启用权限。

多数据库支持无需指定具体数据库即可连接多个数据库。

优势与局限性

优势

简化AI与数据库的交互流程

支持多种查询安全防护机制

兼容主流开发工具和平台

局限性

对数据库性能有一定影响

需要适当的MySQL权限配置

如何使用

安装依赖

确保已安装Node.js v18及以上版本。

配置环境变量

设置MySQL连接信息，如主机、端口、用户名和密码。

启动服务器

运行服务器以连接到数据库。

使用案例

示例1：执行查询查询用户表中的所有记录。

示例2：插入新记录向订单表插入一条新订单。

常见问题

如何启用写操作权限？

如何解决连接失败的问题？

如何监控查询性能？

相关资源

官方文档

全面了解服务器功能和配置方法。

GitHub仓库

源码地址和贡献指南。

教程视频

快速上手视频教程。

安装

复制以下命令到你的Client进行配置

{
  "mcpServers": {
    "MySQL": {
      "command": "npx",
      "args": [
        "mcprunner",
        "MYSQL_HOST=127.0.0.1",
        "MYSQL_PORT=3306",
        "MYSQL_USER=root",
        "MYSQL_PASS=root",
        "MYSQL_DB=demostore",
        "ALLOW_INSERT_OPERATION=true",
        "ALLOW_UPDATE_OPERATION=true",
        "ALLOW_DELETE_OPERATION=false",
        "--",
        "npx",
        "-y",
        "@benborla29/mcp-server-mysql"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "/path/to/npx/binary/npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        // Basic connection settings
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name",
        "PATH": "/path/to/node/bin:/usr/bin:/bin",
        
        // Performance settings
        "MYSQL_POOL_SIZE": "10",
        "MYSQL_QUERY_TIMEOUT": "30000",
        "MYSQL_CACHE_TTL": "60000",
        
        // Security settings
        "MYSQL_RATE_LIMIT": "100",
        "MYSQL_MAX_QUERY_COMPLEXITY": "1000",
        "MYSQL_SSL": "true",
        
        // Monitoring settings
        "MYSQL_ENABLE_LOGGING": "true",
        "MYSQL_LOG_LEVEL": "info",
        "MYSQL_METRICS_ENABLED": "true",
        
        // Write operation flags
        "ALLOW_INSERT_OPERATION": "false",
        "ALLOW_UPDATE_OPERATION": "false",
        "ALLOW_DELETE_OPERATION": "false"
      }
    }
  }
}

{
       "mcpServers": {
         "mcp_server_mysql": {
           "command": "/full/path/to/node",
           "args": [
             "/full/path/to/mcp-server-mysql/dist/index.js"
           ],
           "env": {
             "MYSQL_HOST": "127.0.0.1",
             "MYSQL_PORT": "3306",
             "MYSQL_USER": "root",
             "MYSQL_PASS": "your_password",
             "MYSQL_DB": "your_database"
           }
         }
       }
     }

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 MCP 服务器 MySQL

MCP 服务器 MySQL 是一个相关项目，可帮助你利用 MySQL 进行服务器相关操作，为你的应用提供稳定的数据存储与交互支持。

🚀 快速开始

若你想使用 MCP 服务器 MySQL，可按照以下步骤进行操作。

📦 安装指南

Windows 安装指南

下载 Node.js
访问 Node.js 官网下载并安装 Node.js。请确保选择 LTS 版本以获得更好的兼容性和稳定性。
验证安装
打开命令提示符，输入以下命令检查是否安装成功：

node -v  # 查看 Node.js 版本
npm -v    # 查看 npm 版本

全局安装 pnpm
使用 npm 安装 pnpm：

npm install -g pnpm

克隆仓库
打开命令提示符，运行以下命令克隆 MCP 服务器 MySQL 仓库：

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql

安装依赖项
在仓库目录中，运行以下命令安装所有依赖项：

pnpm install

构建项目
安装完成后，运行以下命令构建项目：

pnpm run build

启动 MCP 服务器
构建完成后，运行以下命令启动 MCP 服务器：

pnpm start

macOS 安装指南

下载 Node.js
访问 Node.js 官网下载并安装 Node.js。请确保选择 LTS 版本以获得更好的兼容性和稳定性。
验证安装
打开终端，输入以下命令检查是否安装成功：

node -v  # 查看 Node.js 版本
npm -v    # 查看 npm 版本

全局安装 pnpm
使用 npm 安装 pnpm：

npm install -g pnpm

克隆仓库
打开终端，运行以下命令克隆 MCP 服务器 MySQL 仓库：

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql

安装依赖项
在仓库目录中，运行以下命令安装所有依赖项：

pnpm install

构建项目
安装完成后，运行以下命令构建项目：

pnpm run build

启动 MCP 服务器
构建完成后，运行以下命令启动 MCP 服务器：

pnpm start

📚 详细文档

配置指南

安装依赖项

在仓库目录中，运行以下命令安装所有依赖项：

pnpm install

运行 MCP 服务器

要运行 MCP 服务器，请确保项目已构建。然后在终端或命令提示符中运行以下命令：

pnpm start

配置参数

MCP 服务器 MySQL 支持以下配置参数：

port：指定服务器监听的端口（默认值为 3000）。
host：指定服务器绑定的主机地址（默认值为 localhost）。

示例：

# 配置文件路径
config:
  port: 3001
  host: 127.0.0.1

常见问题

问题：如何解决 SSL 配置问题？

解答：

确保 MySQL 服务器启用了 SSL 支持。
检查 SSL 证书和密钥文件是否正确配置。
在连接字符串中指定 ssl 属性。

示例：

# 配置文件路径
config:
  ssl: true
  cert: /path/to/cert.pem
  key: /path/to/key.pem

问题：如何解决用户权限问题？

解答：

确保 MySQL 用户具有足够的权限。
检查用户是否允许从指定的 IP 地址连接。

示例：

# 配置文件路径
config:
  user: root
  password: yourpassword
  database: yourdatabase

贡献指南

提交代码

git checkout -b feature/your-feature-name

提交更改：

git add .
git commit -m "你的提交信息"

推送到远程仓库并发起拉取请求：

git push origin feature/your-feature-name

欢迎贡献！

我们欢迎任何改进或修复。请参考 CONTRIBUTING.md 文件了解如何为项目贡献力量。

问题报告

提交问题

在 GitHub 仓库中创建一个新的问题。
提供详细的错误日志和上下文信息。

示例：

# 错误日志路径
error.log:
Error: Cannot connect to MySQL server

感谢您使用 MCP 服务器 MySQL！如果有任何问题，请随时提交反馈。

精选MCP服务推荐

Figma Context MCP

Framelink Figma MCP Server是一个为AI编程工具（如Cursor）提供Figma设计数据访问的服务器，通过简化Figma API响应，帮助AI更准确地实现设计到代码的一键转换。

Firecrawl MCP Server是一个集成Firecrawl网页抓取能力的模型上下文协议服务器，提供丰富的网页抓取、搜索和内容提取功能。

TypeScript

4.3K

5分

Duckduckgo MCP Server

已认证

DuckDuckGo搜索MCP服务器，为Claude等LLM提供网页搜索和内容抓取服务

MiniMax Model Context Protocol (MCP) 是一个官方服务器，支持与强大的文本转语音、视频/图像生成API交互，适用于多种客户端工具如Claude Desktop、Cursor等。

百度地图MCP Server是国内首个兼容MCP协议的地图服务，提供地理编码、路线规划等10个标准化API接口，支持Python和Typescript快速接入，赋能智能体实现地图相关功能。

Exa MCP Server是一个为AI助手（如Claude）提供网络搜索功能的服务器，通过Exa AI搜索API实现实时、安全的网络信息获取。

Context7 MCP是一个为AI编程助手提供实时、版本特定文档和代码示例的服务，通过Model Context Protocol直接集成到提示中，解决LLM使用过时信息的问题。

TypeScript

5.6K

4.7分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一个通过MCP协议快速部署HTML内容到EdgeOne Pages并获取公开URL的服务

智启未来，您的人工智能解决方案智库