@enemyrr/mcp-mysql-server

一个提供MySQL数据库操作的模型上下文协议（Model Context Protocol）服务器。此服务器使AI模型能够通过标准化接口与MySQL数据库交互。

安装与设置（针对Cursor IDE）

使用Smithery自动安装

通过Smithery自动安装适用于Claude桌面版的MySQL数据库服务器：

npx -y @smithery/cli install @enemyrr/mcp-mysql-server --client claude

手动安装

1. 克隆并构建项目：

git clone https://github.com/enemyrr/mcp-mysql-server.git
cd mcp-mysql-server
npm install
npm run build

2. 在Cursor IDE设置中添加服务器：
   • 打开命令palette（Cmd/Ctrl + Shift + P）
   • 搜索“MCP: 添加服务器”
   • 填写以下信息：
     • 名称：mysql
     • 类型：command
     • 命令：node /绝对路径/to/mcp-mysql-server/build/index.js

注意：将/绝对路径/to/mcp-mysql-server替换为实际的项目路径。

数据库配置

• 使用数据库URL环境变量：

  DATABASE_URL=mysql://用户名:密码@主机:端口/数据库名
  

• 单独参数配置：

  • 用户名：通过DB_USER或从URL解析。
  • 密码：通过DB_PASS或从URL解析。
  • 主机：通过DB_HOST或从URL解析。
  • 端口：通过DB_PORT或从URL解析，默认为3306。
  • 数据库名：通过DB_NAME或从URL解析。

• 直接连接工具：

  {
    "driver": "mysql",
    "options": {
      "host": "主机地址",
      "port": 端口号,
      "database": "数据库名称",
      "username": "用户名",
      "password": "密码"
    }
  }
  

可用工具

查询执行

/**
 * @param {string} query SQL查询语句
 * @param {any[]} parameters 查询参数数组
 */
async function executeQuery(query, parameters) => Promise<void>

查询获取结果集

/**
 * @param {string} query SQL查询语句
 * @param {any[]} parameters 查询参数数组
 */
async function queryResultSet(query, parameters) => Promise<Row[]>

功能

• 支持多种连接方式（URL、工作区、直接）
• 提供安全的连接处理和自动清理功能
• 支持预编译语句以防止SQL注入
• 包含数据库表结构管理工具
• 具备全面的错误处理和验证机制
• 支持TypeScript
• 自动检测工作区

安全性

• 使用预编译语句防止SQL注入攻击
• 通过环境变量安全处理密码
• 在执行前对查询进行验证
• 执行完成后自动关闭连接

错误处理

服务器提供详细的错误信息，涵盖以下情况：

• 连接失败
• 无效查询或参数
• 配置缺失
• 数据库错误
• 模式验证错误

贡献

欢迎社区贡献！请访问GitHub仓库提交Pull Request。

许可证

MIT