MySQL MCP 服务器

一个提供只读访问MySQL数据库的模型上下文协议（Model Context Protocol）服务器。此服务器使大型语言模型（LLM）能够查看数据库架构并执行只读查询。

认证

该服务器通过数据库URL支持MySQL认证。URL格式如下：

mysql://用户名:密码@主机:端口/数据库

示例：

• 数据库：mysql://user:pass@localhost:3306/mydb

注意：始终确保您的凭证安全，不公开配置。

组件

工具

• query
  • 执行只读SQL查询针对连接的数据库
  • 输入：sql（字符串）：要执行的SQL查询
  • 所有查询都在一个只读事务中执行
  • 使用提供的凭证自动处理身份验证

资源

服务器为每个表提供数据库架构信息：

• 表格架构（mysql://<host>/<table>/schema）
  • 每个表的JSON架构信息
  • 包括列名和数据类型
  • 自动从数据库元数据中发现
  • 使用提供的凭证进行身份验证访问

安装

1. 克隆仓库：

git clone https://github.com/yourusername/mysql-mcp-server.git
cd mysql-mcp-server

2. 准备并安装依赖项：

npm run prepare
npm install

3. 创建全局链接：

npm link

现在，您可以在终端的任何位置使用mysql-mcp-server命令：

mysql-mcp-server mysql://user:password@localhost:3306/mydb

使用与Cursor

在Cursor中配置MCP

1. 打开Cursor的设置：

   • 点击底部左下角的齿轮图标（⚙️）
   • 或者按Shift + Cmd + J在macOS上

2. 配置MCP服务器：

   • 点击左侧边栏中的“MCP”
   • 点击“添加全局MCP服务器”
   • 添加以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "mysql-mcp-server",
      "args": ["mysql://user:password@localhost:3306/mydb"]
    }
  }
}

3. 保存配置：
   • 点击“保存”或按Cmd + S
   • 重启Cursor以使更改生效

如何在Cursor中使用它？

在Cursor中的智能聊天窗口打开，并开始与数据库相关的问题提问，它将拥有所有上下文。

安全最佳实践

1. 使用环境变量保存敏感凭证：

   {
     "mcpServers": {
       "mysql": {
         "command": "mysql-mcp-server",
         "args": ["mysql://${MYSQL_USER}:${MYSQL_PASSWORD}@host:3306/mydb"]
       }
     }
   }
   

2. 确保MySQL用户具有最小的必需权限（只读访问）

3. 使用强密码并遵循安全最佳实践

4. 避免将包含凭证的配置文件提交到版本控制系统

许可证

此MCP服务器根据MIT许可证发布。这意味着您可以自由使用、修改和分发软件，但需遵守MIT许可证的条款和条件。有关详细信息，请参阅项目仓库中的LICENSE文件。