
MySQL MCP Server

2025.04.29
0
TypeScript数据库管理SQL 查询数据库
MySQL MCP Server 是一个基于 Model Context Protocol (MCP) 的工具,旨在为大型语言模型 (LLM) 提供与本地 MySQL 数据库交互的能力。它允许 LLM 直接执行 SQL 查询,获取数据库信息,并与 MySQL 数据库进行无缝集成。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server 是一个用于连接本地 MySQL 数据库的工具,使大型语言模型 (LLM) 能够执行 SQL 查询并获取数据库信息。
核心功能
- MySQL 查询执行:允许 LLM 直接执行 SQL 查询。
- 数据库信息获取:支持获取数据库列表、表列表和表结构信息。
- MCP 协议支持:符合 Model Context Protocol,可与 LLM 集成。
- stdio 通信:使用标准输入输出进行通信,无需绑定端口。
- 连接信息保存:本地保存数据库连接信息,便于后续复用。
适用场景
- LLM 与 MySQL 数据库的交互。
- 数据库信息的快速查询和结构分析。
- 开发环境中的数据库调试和管理。
工具列表
- 数据库连接管理:
connect_database
:连接数据库。disconnect_database
:断开数据库连接。get_connection_status
:获取连接状态。- SQL 查询操作:
execute_query
:执行 SQL 查询。get_databases
:获取数据库列表。get_tables
:获取表列表。describe_table
:获取表结构。
常见问题解答
- 通信方式:使用 stdio 模式,避免端口冲突。
- 连接信息保存:保存在
~/.mysql-mcp-connections.json
文件中。 - 调试模式:通过
--debug
参数启用。
使用教程
使用依赖
- Node.js: 20.0.0 或更高版本。
- MySQL: 5.7 或更高版本的 MySQL 或 MariaDB 服务器。
安装教程
- 临时运行:
bash npx -y https://github.com/yuki777/mysql-mcp-server --host 127.0.0.1 --port 13306 --user root
- 使用配置文件:
bash npx -y https://github.com/yuki777/mysql-mcp-server -c ./mysql-mcp-config.json
调试方式
- 测试连接管理:
bash node test-connection-management.js
- 开发模式:
bash npm run dev
- 构建:
bash npm run build