MySQL MCP 服务器

一个提供 MySQL 数据库只读访问的模型上下文协议服务器。该服务器使 LLM 能够检查数据库模式并执行只读查询。

认证

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

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

示例：

• DB: mysql://user:pass@localhost:3306/mydb

注意：始终确保您的凭证安全且不会暴露在公共配置中。

组件

工具

• query
  • 对连接的数据库执行只读 SQL 查询
  • 输入：sql (字符串)：要执行的 SQL 查询
  • 所有查询都在 READ ONLY 事务中执行
  • 认证使用提供的凭证自动处理

资源

服务器提供数据库中每个表的模式信息：

• 表模式 (mysql://<主机>/<表>/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 的设置：

   • 点击左下角的齿轮图标 (⚙️)
   • 或在 macOS 上按 Shift + Cmd + J

2. 配置 MCP 服务器：

   • 点击左侧边栏中的 "MCP"
   • 点击 "Add Global MCP Server"
   • 添加以下配置：

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

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

如何在 Cursor 中使用？

打开 Cursor 的 Agentic 聊天并开始询问与我们的 DB 相关的问题，它将拥有所有上下文

安全最佳实践

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

   json 复制代码

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

2. 确保 MySQL 用户具有最低必要权限（只读访问）

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

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

许可证

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