@enemyrr/mcp-mysql-server

基本能力

产品定位

enemyrr_mcp-mysql-server 是一个专门为 AI 模型设计的 MySQL 数据库操作服务器，通过标准化接口简化数据库交互流程。

核心功能

• 提供多种 MySQL 数据库连接方式（URL、工作区路径、直接凭据）
• 支持安全连接处理和自动清理
• 提供查询参数预处理支持
• 包含丰富的数据库操作工具（查询、执行、表管理、列管理等）
• 全面的错误处理和验证机制
• TypeScript 支持
• 自动工作区检测

适用场景

• AI 模型需要与 MySQL 数据库交互的场景
• 需要标准化数据库操作接口的开发项目
• 需要安全数据库连接管理的应用
• 需要丰富数据库操作工具的开发环境

工具列表

1. connect_db: 使用 URL、工作区路径或直接凭据连接到 MySQL 数据库
2. query: 执行 SELECT 查询，支持预处理参数
3. execute: 执行 INSERT、UPDATE 或 DELETE 查询，支持预处理参数
4. list_tables: 列出连接数据库中的所有表
5. describe_table: 获取特定表的结构
6. create_table: 创建具有指定字段和索引的新表
7. add_column: 向现有表添加新列

常见问题解答

• 连接问题: 确保提供正确的数据库凭据或 URL
• 查询错误: 检查 SQL 语法和参数是否正确
• 配置问题: 确保 .env 文件或直接参数配置正确
• 权限问题: 确保数据库用户有足够的权限执行操作

使用教程

使用依赖

• Node.js 环境
• MySQL 数据库

安装教程

通过 Smithery 自动安装

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

1. 在 Cursor IDE 中添加服务器:
2. 打开命令面板 (Cmd/Ctrl + Shift + P)
3. 搜索 "MCP: Add Server"
4. 填写字段:
   • Name: mysql
   • Type: command
   • Command: node /absolute/path/to/mcp-mysql-server/build/index.js

注意: 将 /absolute/path/to/ 替换为实际项目路径

数据库配置

有三种配置方式:

1. 在 .env 中使用数据库 URL (推荐):

DATABASE_URL=mysql://user:password@host:3306/database

1. 在 .env 中使用单独参数:

DB_HOST=localhost
DB_USER=your_user
DB_PASSWORD=your_password
DB_DATABASE=your_database

1. 通过工具直接连接:

use_mcp_tool({
  server_name: "mysql",
  tool_name: "connect_db",
  arguments: {
    url: "mysql://user:password@host:3306/database"
    // 或
    workspace: "/path/to/your/project" // 使用项目的 .env
    // 或
    host: "localhost",
    user: "your_user",
    password: "your_password",
    database: "your_database"
  }
});

调试方式

1. 确保数据库服务正常运行
2. 检查连接配置是否正确
3. 使用简单查询测试连接:

use_mcp_tool({
  server_name: "mysql",
  tool_name: "query",
  arguments: {
    sql: "SELECT 1"
  }
});

1. 检查错误日志获取详细错误信息

许可证

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