MySQL连接器
无缝连接和与MySQL数据库交互。执行SQL查询，管理数据库连接，并通过人工智能助手直接检索数据。通过结构化访问您的MySQL数据来增强人工智能能力。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mysql": {
"args": [
"mysql-mcp"
],
"command": "node",
"env": {
"MYSQL_DATABASE": "your_database",
"MYSQL_HOST": "localhost",
"MYSQL_PASSWORD": "your_password",
"MYSQL_PORT": "3306",
"MYSQL_READONLY": "true",
"MYSQL_USER": "root"
}
}
}
}该服务需要配置环境变量：MYSQL_DATABASE、MYSQL_HOST、MYSQL_PASSWORD、MYSQL_PORT、MYSQL_READONLY、MYSQL_USER
可用工具 （9 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
status 1 个参数 需填 1 项
Check the current database connection status.
必填参数：random_string
connect 5 个参数
Connect to a MySQL database.
该工具无需必填参数，直接调用即可
disconnect 1 个参数 需填 1 项
Close the current MySQL database connection.
必填参数：random_string
query 2 个参数 需填 1 项
Execute an SQL query on the connected database.
必填参数：sql
list_tables 1 个参数 需填 1 项
Get a list of tables in the current database.
必填参数：random_string
describe_table 1 个参数 需填 1 项
Get the structure of a specific table.
必填参数：table
list_databases 1 个参数 需填 1 项
Get a list of all accessible databases on the server.
必填参数：random_string
use_database 1 个参数 需填 1 项
Switch to a different database.
必填参数：database
set_readonly 1 个参数 需填 1 项
Enable or disable read-only mode
必填参数：readonly
服务介绍
MySQL MCP 服务器
这是一个为 MySQL 数据库设计的模型上下文协议 (MCP) 服务器，它允许 AI 模型通过结构化接口与 MySQL 数据库进行交互。
概述
MySQL MCP 服务器为 AI 模型和 MySQL 数据库之间提供了一个桥梁，使 AI 代理能够查询和分析 MySQL 数据。此实现遵循 Model Context Protocol 规范，并提供了 Web 服务器和 CLI 两种操作模式。
功能
- MySQL 数据库连接管理
- SQL 查询执行
- 表列表和结构检查
- 数据库列表和选择
- 通过 SSE（服务器发送事件）实现实时状态监控
- 用于测试 MCP 工具的 Web 界面
- 支持 stdio 和 SSE 传输方法
- 准备好 Docker 部署
安装
# Global installation
npm install -g mysql-mcp
# Local installation
npm install mysql-mcp
与 AI 助手一起使用
使用在 Smithery.ai 上发布的服务器
MySQL MCP 服务器已在 Smithery.ai 上发布，可以轻松地与各种 AI 助手一起使用：
-
配置服务器：
- 设置您的 MySQL 数据库连接详细信息：
- MYSQL_HOST
- MYSQL_PORT
- MYSQL_USER
- MYSQL_PASSWORD
- MYSQL_DATABASE
- MYSQL_READONLY（可选，设置为 True 以启用只读访问）
- 设置您的 MySQL 数据库连接详细信息：
-
与支持的 AI 平台连接：
- Anthropic Claude
- Cursor AI
- Windsurf
- Cline
- Witsy
- Enconvo
- Goose
-
认证：登录到 Smithery.ai 保存您的配置并生成认证令牌。
-
在 AI 提示中使用：一旦连接成功，您可以通过请求助手执行数据库操作，在 AI 对话中利用 MySQL 工具。
使用本地安装后的版本
要使用本地开发的版本：
- 在项目目录中运行
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"
}
}
}
}
工具
status
检查当前数据库连接状态。
- 输入：不需要参数
- 返回：如果已连接，则返回包含主机、端口、数据库和用户名的连接状态信息。
connect
连接到 MySQL 数据库。
- 输入：
- host（可选字符串）：数据库服务器主机名或 IP 地址
- port（可选字符串）：数据库服务器端口
- user（可选字符串）：数据库用户名
- password（可选字符串）：数据库密码
- database（可选字符串）：要连接的数据库名称
- 返回：连接成功消息或错误详情。
disconnect
关闭当前的 MySQL 数据库连接。
- 输入：不需要参数
- 返回：断开连接成功消息或错误详情。
query
在已连接的数据库上执行 SQL 查询。
- 输入：
- sql (字符串)：要执行的 SQL 查询
- params (可选数组)：预处理语句的参数
- 返回：查询结果以 JSON 格式返回，或者返回错误消息。
list_tables
获取当前数据库中的表列表。
- 输入：不需要参数
- 返回：当前数据库中的表名列表。
describe_table
获取特定表的结构。
- 输入：
- table (字符串)：要描述的表名
- 返回：表结构详细信息，包括列、类型、键和其他属性。
list_databases
获取服务器上所有可访问的数据库列表。
- 输入：不需要参数
- 返回：服务器上可用的数据库名称列表。
use_database
切换到另一个数据库。
- 输入：
- database (字符串)：要切换到的数据库名
- 返回：确认消息或错误详情。
关键词
mysql, mcp, 数据库, ai, 模型上下文协议
许可证
MIT
