@kohlarnhin/mcp-server-mysql

MCP Server MySQL

Model Context Protocol server for MySQL databases.

简介

MCP Server MySQL 是一个用于连接 MySQL 数据库的 Model Context Protocol 服务器。它允许 AI 助手和应用程序通过标准的 MCP 协议接口安全地查询 MySQL 数据库。

功能

• 提供标准的 MCP 接口，用于执行 MySQL 查询
• 支持 INSERT, UPDATE 和 READ 操作
• 内置连接池管理
• 安全的错误处理和日志记录
• 使用官方 MCP SDK，兼容 Cursor 和其他 MCP 客户端

安装

全局安装（推荐）

npm install -g @kohlarnhin/mcp-server-mysql

本地安装

npm install @kohlarnhin/mcp-server-mysql

使用方法

直接运行

通过环境变量配置数据库连接信息：

MYSQL_HOST=127.0.0.1 MYSQL_PORT=3306 MYSQL_USER=root MYSQL_PASS=yourpassword MYSQL_DB=yourdb mcp-server-mysql

在 MCP 配置中使用

在 ~/.cursor/mcp.json 中添加以下配置：

{
  "mcpServers": {
    "MySQL": {
      "command": "npx",
      "args": [
        "mcprunner",
        "MYSQL_HOST=127.0.0.1",
        "MYSQL_PORT=3306",
        "MYSQL_USER=root",
        "MYSQL_PASS=yourpassword",
        "MYSQL_DB=yourdb",
        "ALLOW_INSERT_OPERATION=true",
        "ALLOW_UPDATE_OPERATION=true",
        "ALLOW_DELETE_OPERATION=false",
        "--",
        "npx",
        "-y",
        "@kohlarnhin/mcp-server-mysql"
      ],
      "type": "stdio"
    }
  }
}

配置选项

通过环境变量进行配置：

环境变量	描述	默认值
MYSQL_HOST	MySQL 服务器主机名	127.0.0.1
MYSQL_PORT	MySQL 服务器端口	3306
MYSQL_USER	MySQL 用户名	root
MYSQL_PASS	MySQL 密码	123456
MYSQL_DB	MySQL 数据库名	oc-dev
ALLOW_INSERT_OPERATION	是否允许 INSERT 操作	true
ALLOW_UPDATE_OPERATION	是否允许 UPDATE 操作	true
ALLOW_DELETE_OPERATION	是否允许 DELETE 操作	false

工具列表

服务提供以下工具：

• mcp_MySQL_mysql_query: 执行 SQL 查询并返回结果

示例

在支持 MCP 的应用程序中：

-- 查询示例
SELECT * FROM users LIMIT 10;

-- 插入示例 (如果允许)
INSERT INTO logs (message, level) VALUES ('测试消息', 'info');

版本历史

• 1.1.0 - 稳定版本发布，修复了文档问题，完善了配置说明
• 1.0.x - 初始开发版本（已撤回）

注意事项

1. 安全考虑：默认情况下，DELETE 操作是禁用的。如需启用，请将 ALLOW_DELETE_OPERATION 设置为 true。

2. 环境变量优先级：命令行传递的环境变量优先级高于系统环境变量。

许可证

MIT