@enemyrr/mcp-mysql-server

基本能力

产品定位

mcp-server-mysql 是一个 MySQL 数据库操作中间件，旨在为 AI 模型提供标准化的数据库访问能力。

核心功能

• 提供多种 MySQL 数据库连接方式（URL、工作区路径、直接凭据）
• 支持 SELECT 查询（带参数绑定）
• 支持 INSERT/UPDATE/DELETE 操作
• 提供表结构管理功能（创建表、添加列等）
• 支持表结构查询（列出表、描述表结构）
• 全面的错误处理和验证机制
• TypeScript 支持
• 自动工作区检测

适用场景

• AI 模型需要访问 MySQL 数据库的场景
• 需要标准化数据库操作接口的开发环境
• 需要安全执行 SQL 查询的应用
• 数据库表结构管理的自动化场景

工具列表

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 和 npm 环境。

安装教程

通过 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

调试方式

1. 配置数据库连接（通过 .env 文件或直接参数）
2. 使用示例工具调用测试连接：

use_mcp_tool({
  server_name: "mysql",
  tool_name: "list_tables"
});

1. 检查返回结果或错误信息

许可证

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