
MySQL MCP Server

2025.04.03
3
TypeScript数据库连接AI 数据库交互数据库
MySQL MCP Server 是一个遵循 Model Context Protocol (MCP) 规范的服务器,旨在为 AI 模型与 MySQL 数据库之间提供结构化的交互接口。它支持通过 Web 服务器和 CLI 模式操作,使 AI 代理能够查询和分析 MySQL 数据。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server 是一个桥梁工具,专门设计用于连接 AI 模型与 MySQL 数据库,提供结构化的数据交互能力。
核心功能
- MySQL 数据库连接管理
- SQL 查询执行
- 表列表和结构检查
- 数据库列表和选择
- 通过 SSE (Server-Sent Events) 实时状态监控
- 提供 Web 界面测试 MCP 工具
- 支持 stdio 和 SSE 传输方法
- 支持 Docker 部署
适用场景
- AI 模型需要访问和操作 MySQL 数据库的场景
- 需要实时监控数据库状态的 AI 应用
- 开发者在本地或云端快速搭建 MySQL 与 AI 交互的桥梁
工具列表
- status: 检查当前数据库连接状态。
- connect: 连接到 MySQL 数据库。
- disconnect: 关闭当前 MySQL 数据库连接。
- query: 在连接的数据库上执行 SQL 查询。
- list_tables: 获取当前数据库中的表列表。
- describe_table: 获取特定表的结构。
- list_databases: 获取服务器上所有可访问的数据库列表。
- use_database: 切换到不同的数据库。
常见问题解答
- 如何配置数据库连接? 通过设置环境变量:MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE, 和可选的 MYSQL_READONLY。
- 支持哪些 AI 平台? Anthropic Claude, Cursor AI, Windsurf, Cline, Witsy, Enconvo, Goose。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
# 全局安装
npm install -g mysql-mcp
# 本地安装
npm install mysql-mcp
调试方式
- 运行
npm link
在项目目录中。 - 配置设置文件如下:
{
"mcpServers": {
"mysql": {
"command": "node",
"args": ["mysql-mcp"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "your_database",
"MYSQL_READONLY": "true"
}
}
}
}