@f4ww4z/mcp-mysql-server
2025.03.23
0
JavaScript数据库服务AI数据库接口数据库
Atomzzm_mcp-mysql-server 是一个基于 Model Context Protocol 的服务器，专门用于提供 MySQL 数据库操作功能。它通过标准化接口使 AI 模型能够与 MySQL 数据库进行交互，支持多种数据库操作，包括连接管理、查询执行、表结构查看等。
View on GitHub
Overview
基本能力
产品定位
Atomzzm_mcp-mysql-server 是一个专为 AI 模型设计的 MySQL 数据库操作接口服务器，旨在简化 AI 与数据库的交互过程。
核心功能
- 提供安全的 MySQL 数据库连接管理
- 支持 SELECT、INSERT、UPDATE、DELETE 等 SQL 查询的执行
- 支持预处理语句，防止 SQL 注入
- 提供表结构查看和表列表功能
- 全面的错误处理和验证机制
- TypeScript 支持
- 自动连接管理
适用场景
- AI 模型需要访问和操作 MySQL 数据库
- 需要安全地执行数据库查询而不直接暴露数据库凭据
- 需要自动化数据库操作的工作流程
- 开发需要与数据库交互的 AI 应用
工具列表
- connect_db：使用提供的凭据建立与 MySQL 数据库的连接
- query：执行 SELECT 查询，支持可选预处理语句参数
- execute：执行 INSERT、UPDATE 或 DELETE 查询，支持可选预处理语句参数
- list_tables：列出连接数据库中的所有表
- describe_table：获取特定表的结构
常见问题解答
- 连接失败：检查主机、用户名、密码和数据库名称是否正确
- 无效查询：确保 SQL 语法正确
- 缺少参数：确保所有必需参数都已提供
- 数据库错误：检查数据库日志获取详细信息
使用教程
使用依赖
无特殊依赖，只需 Node.js 环境
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @f4ww4z/mcp-mysql-server --client claude
手动安装
npx @f4ww4z/mcp-mysql-server
配置
需要在 MCP 设置配置文件中设置以下环境变量：
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@f4ww4z/mcp-mysql-server"],
"env": {
"MYSQL_HOST": "your_host",
"MYSQL_USER": "your_user",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database"
}
}
}
}
调试方式
安装完成后，可以通过执行各种工具命令来测试服务器功能，例如：
use_mcp_tool({
server_name: "mysql",
tool_name: "list_tables",
arguments: {}
});