@f4ww4z/mcp-mysql-server
2025.02.22
0
数据库操作MySQL 接口数据库
mcp-mysql-server 是一个基于 Model Context Protocol 的服务器，提供 MySQL 数据库操作功能。它通过标准化接口使 AI 模型能够与 MySQL 数据库进行交互，支持安全连接、查询执行、表结构查看等多种数据库操作。
View on GitHub
Overview
基本能力
产品定位
mcp-mysql-server 是一个专门为 AI 模型设计的 MySQL 数据库操作接口服务器，旨在简化 AI 模型与 MySQL 数据库的交互过程。
核心功能
- 安全连接处理与自动清理
- 支持带参数的预处理语句
- 全面的错误处理和验证
- TypeScript 支持
- 自动连接管理
适用场景
- AI 模型需要与 MySQL 数据库交互的场景
- 需要执行 SQL 查询、插入、更新或删除操作的自动化流程
- 数据库表结构查看和管理
工具列表
- connect_db：使用提供的凭据建立与 MySQL 数据库的连接
- query：执行 SELECT 查询，支持带参数的预处理语句
- execute：执行 INSERT、UPDATE 或 DELETE 查询，支持带参数的预处理语句
- list_tables：列出连接数据库中的所有表
- describe_table：获取特定表的结构
常见问题解答
- 连接失败：检查环境变量中的 MySQL 主机、用户、密码和数据库名称是否正确
- 无效查询：服务器会验证查询语法，错误消息会指出问题所在
- 缺少参数：确保为需要参数的查询提供了所有必要参数
- 数据库错误：服务器会返回详细的数据库错误信息
使用教程
使用依赖
安装前需要确保已安装 Node.js 和 npm。
安装教程
通过 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: "query",
arguments: {
sql: "SELECT * FROM users WHERE id = ?",
params: [1]
}
});