
MySQL MCP Server

2025.04.01
1
TypeScript数据库服务数据库
MySQL MCP Server是一个基于Model Context Protocol (MCP)的MySQL服务器,允许通过MCP协议执行SQL查询。它提供了执行SQL查询、检查数据库连接状态以及内置SQL查询示例提示等功能。适用于需要通过MCP协议与MySQL数据库交互的场景。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server是一个基于MCP协议的MySQL服务器,旨在通过MCP协议提供MySQL数据库的交互能力。
核心功能
- 通过MCP协议执行SQL查询
- 检查数据库连接状态
- 内置SQL查询示例提示
适用场景
- 需要通过MCP协议与MySQL数据库交互的应用
- 需要远程执行SQL查询的场景
- 数据库连接状态监控
工具列表
execute_sql
: 执行SQL查询check_connection
: 检查数据库连接状态sql_example
: 提供SQL查询示例
使用教程
使用依赖
- 确保已安装Node.js和npm
- 确保已安装Git
安装教程
# 克隆仓库
git clone https://github.com/shengshengshengbuxi/mysql_mcp_server.git
cd mysql_mcp_server
# 安装依赖
npm install
# 编译TypeScript代码
npm run build
配置
服务器使用以下环境变量进行配置:
- MYSQL_HOST
: MySQL主机地址(默认: localhost)
- MYSQL_PORT
: MySQL端口(默认: 3306)
- MYSQL_USER
: MySQL用户名(默认: root)
- MYSQL_PASSWORD
: MySQL密码(默认: 空)
- MYSQL_DATABASE
: MySQL数据库名(默认: 空)
运行
# 设置MySQL连接参数
$env:MYSQL_HOST = "localhost"
$env:MYSQL_PORT = "3306"
$env:MYSQL_USER = "root"
$env:MYSQL_PASSWORD = "your_password"
$env:MYSQL_DATABASE = "your_database"
# 运行服务器
npm start
与Claude集成
要在Claude Desktop中使用此服务器,请编辑Claude Desktop配置文件:
Windows:
%USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json
添加以下配置:
{
"mcpServers": {
"mysql": {
"command": "node",
"args": [
"/path/to/mysql_mcp_server/dist/server.js",
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "your password",
"MYSQL_DATABASE": "your database"
}
}
}
}
调试方式
- 确保MySQL服务正在运行
- 检查环境变量是否正确设置
- 运行服务器后,尝试使用提供的工具进行测试
- 查看控制台输出以获取错误信息