Mysql Database Server

🚀 @enemyrr/mcp-mysql-server

一个提供 MySQL 数据库操作的 Model Context Protocol 服务器，该服务器可让 AI 模型借助标准化接口与 MySQL 数据库进行交互。

🚀 快速开始

✨ 主要特性

• 支持多种连接方式（URL、工作区、直接）
• 提供安全的连接处理和自动清理
• 支持 prepared statements 以防止 SQL 注入
• 提供 Schema 管理工具
• 具有全面的错误处理和验证
• 支持 TypeScript
• 自动检测工作区

📦 安装指南

通过 Smithery 安装

要自动通过 Smithery 安装 Claude Desktop 的 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: Add Server”
   • 填写信息：
     • 名称：mysql
     • 类型：command
     • 命令：node /绝对路径/to/mcp-mysql-server/build/index.js

⚠️ 重要提示

需将 /absolute/path/to/ 替换为实际克隆和构建项目的路径。

数据库配置

你可以通过三种方式配置数据库连接：

方式一：在.env 中的 Database URL（推荐）

DATABASE_URL = mysql://username:password@host:port/database

方式二：单独设置 DB 参数

DB_HOST = host
DB_USER = username
DB_PASSWORD = password
DB_NAME = database
DB_PORT = port

方式三：通过工具直接连接并提供详细信息。

💻 使用示例

基础用法

本服务器提供了一系列工具，可用于数据库的各种操作，以下是部分工具的使用说明：

- `connect_db`：用于建立数据库连接。
- `query`：执行查询，支持 prepared statements。
- `execute`：执行非查询操作。
- `list_tables`：列出所有表。
- `get_columns`：获取指定表的列信息。
- `execute_query`：执行自定义查询。
- `insert_data`：插入数据。
- `update_data`：更新数据。
- `delete_data`：删除数据。

🔧 技术细节

安全机制

• 使用 prepared statements 防止 SQL 注入
• 通过环境变量支持安全密码处理
• 在执行前验证查询
• 自动关闭连接

错误处理

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

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

📄 许可证

本项目采用 MIT 许可证。

贡献

欢迎贡献！请随意提交 Pull Request 到 https://github.com/enemyrr/mcp-mysql-server 。