
mcp-mysql-server

2025.05.09
0
JavaScript数据库操作AI模型交互数据库
mcp-mysql-server是一个基于Model Context Protocol的MySQL数据库操作服务器,使AI模型能够通过标准化接口与MySQL数据库进行交互。它支持本地和远程部署模式,提供多用户并发支持、高效连接池管理、详细日志记录等功能,适用于需要AI模型与MySQL数据库交互的场景。
View on GitHub
Overview
基本能力
产品定位
mcp-mysql-server是一个基于Model Context Protocol的MySQL数据库操作服务器,旨在为AI模型提供与MySQL数据库交互的标准化接口。
核心功能
- 多用户并发支持:支持同时处理多个用户的请求。
- 高效连接池管理:改进的连接池支持最多50个并发连接。
- 请求级别隔离:每个请求都有唯一标识符,便于跟踪和调试。
- 详细日志记录:记录每个请求的执行过程和资源使用情况。
- 改进的错误处理:更精确地捕获和报告数据库错误。
- 性能优化:连接池复用和优化的连接管理提高处理速度。
- 自动数据库连接:在服务器启动时自动尝试连接数据库。
- 无感知数据库操作:可以直接使用工具如
list_tables
、query
,无需先调用connect_db
。 - 安全性:使用预处理语句防止SQL注入,通过环境变量支持安全密码处理。
适用场景
- AI模型需要与MySQL数据库交互的场景。
- 多用户并发访问MySQL数据库的应用。
- 需要高性能和安全的数据库操作的应用。
工具列表
- connect_db:使用提供的凭据建立与MySQL数据库的连接。
- query:执行SELECT查询,支持可选的预处理语句参数。
- list_tables:列出已连接数据库中的所有表。
- describe_table:获取特定表的结构。
常见问题解答
- 如何配置远程URL模式?:在MCP设置配置文件中使用
url
字段指向远程运行的MCP服务器。 - 如何设置环境变量?:在启动服务器前,通过
export
命令设置MYSQL_HOST
、MYSQL_USER
等环境变量。 - 如何优化性能?:利用连接池管理和请求级别隔离功能,确保高效资源利用。
使用教程
使用依赖
无特殊依赖,只需安装Node.js环境。
安装教程
npx @malove86/mcp-mysql-server
配置
本地运行模式
在MCP设置配置文件中使用以下配置:
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@malove86/mcp-mysql-server"],
"env": {
"MYSQL_HOST": "your_host",
"MYSQL_USER": "your_user",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database",
"MYSQL_PORT": "3306"
}
}
}
}
远程URL模式
在MCP设置配置文件中使用以下配置:
{
"mcpServers": {
"mcp-mysql-server": {
"url": "http://your-server-address:port/mcp-mysql-server"
}
}
}
调试方式
启动服务器后,可以通过日志记录查看请求的执行过程和资源使用情况。
# 设置环境变量
export MYSQL_HOST=your_host
export MYSQL_USER=your_user
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
export MYSQL_PORT=3306
# 启动服务器
npx @malove86/mcp-mysql-server