MCP MySQL Server

用于通过SSH隧道连接MySQL的MCP服务器。

前提条件

• Node.js（版本14或更高）
• 对远程服务器的SSH访问权限
• MySQL客户端
• Cursor IDE

安装

1. 克隆此仓库：

git clone [URL_DEL_REPOSITORIO]
cd [NOMBRE_DEL_DIRECTORIO]

2. 创建配置文件：

cp mcp-config.env.example mcp-config.env

3. 配置 mcp-config.env 中的变量：

MySQL配置变量

# MySQL连接配置
MYSQL_HOST=127.0.0.1     # MySQL主机（默认localhost）
MYSQL_PORT=3306          # MySQL端口（默认3306）
MYSQL_USER=              # 你的MySQL用户名
MYSQL_PASS=              # 你的MySQL密码
MYSQL_DB=                # 数据库名称

# 操作权限
ALLOW_INSERT_OPERATION=false    # 是否允许INSERT操作
ALLOW_UPDATE_OPERATION=false    # 是否允许UPDATE操作
ALLOW_DELETE_OPERATION=false    # 是否允许DELETE操作
ALLOW_SELECT_OPERATION=true     # 是否允许SELECT操作（查询）

# SSH隧道配置
SSH_HOST=                # SSH服务器主机名
SSH_USER=                # SSH用户名
SSH_PORT_MAPPING=3306:127.0.0.1:3306  # SSH隧道端口映射

4. 安装依赖项：

npm install

在Cursor IDE中的配置

1. 找到或创建位于 C:\Users\[TU_USUARIO]\.cursor\mcp.json 的 mcp.json 文件。
2. 添加以下配置（调整路径以指向你克隆仓库的位置）：

{
  "mcpServers": {
    "MySQL": {
      "transportType": "stdio",
      "command": "npm",
      "args": ["--silent", "--prefix", "RUTA_A_TU_PROYECTO", "run", "start-mcp"]
    }
  }
}

例如，如果你将项目克隆到了 C:\proyectos\m.mcp-mysql，配置应如下所示：

{
  "mcpServers": {
    "MySQL": {
      "transportType": "stdio",
      "command": "npm",
      "args": ["--silent", "--prefix", "C:\\proyectos\\mcp-mysql", "run", "start-mcp"]
    }
  }
}

使用方法

启动服务器：

npm run start-mcp

项目结构

• start-mcp.js: 主脚本，用于启动SSH隧道和MCP服务器
• mcp-config.env配置文件（不包含在仓库中）
• package.json依赖项和脚本定义

注意事项

• 不要修改 package.json 中的依赖项版本以保持兼容性
• 确保正确配置了SSH访问权限
• 不要分享你的 mcp-config.env 文件
• 默认情况下，只有SELECT操作是启用的。根据需要修改权限
• 连接到远程数据库时需要SSH隧道。如果使用本地数据库，可以留空SSH配置