MySQL MCP Server

MySQL MCP 服务器

MySQL 模型上下文协议 (MCP) 服务器是一种工具，它允许您连接到本地 MySQL 数据库并允许大型语言模型 (LLM) 对其执行 SQL 查询。

要求

• Node.js ：20.0.0 或更高版本
• MySQL ：MySQL 或 MariaDB 服务器版本 5.7 或更高版本

功能

• 运行 MySQL 查询：直接从 LLM 运行 SQL 查询
• 获取数据库信息：数据库列表、表列表、确认表结构
• 符合 MCP 规范：支持模型上下文协议，可与 LLM 集成
• stdio 通信：使用标准输入/输出与 LLM 通信，无需端口绑定
• 保存连接信息：将数据库连接信息保存在本地并重复使用

安装和使用

NPX 中的临时执行

选项

保存并重复使用连接信息

MySQL MCP 服务器在本地存储已成功连接的数据库的信息。这允许在下次启动时自动重新使用连接信息。保存的连接信息存储在用户主目录中的.mysql-mcp-connections.json文件中。

连接信息包括：

• 主机名
• 端口号
• 用户名
• 密码
• 数据库名称（如果设置）

使用配置文件

您还可以使用配置文件（JSON格式）配置连接信息：

如果您使用配置文件：

沟通方式

MySQL MCP 服务器以符合 MCP（模型上下文协议）的“stdio”模式运行。这使得它能够通过标准输入和输出进行通信，而不是绑定到特定端口。这具有以下优点：

1. 避免端口冲突：不使用特定端口，因此不会发生端口冲突问题
2. 提高安全性：不使用网络通信，降低网络级攻击的风险
3. 简单的进程间通信：简化与 LLM 的通信

注意事项

• 在 stdio 模式下，消息以 JSON 格式发送。
• 必须每行发送一条 JSON 消息
• 错误信息和连接日志输出到标准错误（stderr）。

提供的 MCP 工具

数据库连接管理

SQL查询操作

连接管理功能

MySQL MCP Server 允许您分离服务器启动和数据库连接。这种方法具有以下好处：

1. 无需连接信息即可启动：无需数据库连接信息即可启动服务器。
2. 多数据库连接：服务器启动后，可以切换到不同的数据库连接。
3. 简单安装：只需运行npx -y https://github.com/yuki777/mysql-mcp-server

如何使用连接管理

1. 启动服务器但不自动连接：
   npx -y https://github.com/yuki777/mysql-mcp-server
2. 使用连接工具连接数据库：
   { "type": "tool_call", "request_id": "req_1", "tool": "connect_database", "arguments": { "host": "localhost", "port": 3306, "user": "root", "password": "your_password", "database": "your_db" } }
3. 检查您的连接状态：
   { "type": "tool_call", "request_id": "req_2", "tool": "get_connection_status", "arguments": {} }
4. 连接丢失：
   { "type": "tool_call", "request_id": "req_3", "tool": "disconnect_database", "arguments": {} }

测试脚本

该存储库包含一个名为test-connection-management.js的测试脚本。您可以使用此脚本来测试连接管理功能：

开发者信息

设置开发环境

建造

执照

国际学习中心

贡献

欢迎报告错误、功能请求和拉取请求。