MySQL MCP 服务器

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

身份验证

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

mysql://username:password@host:port/database

例子：

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

注意：始终确保您的凭据得到妥善保护，并且不会在公共配置中暴露。

组件

工具

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

资源

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

• 表模式 (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 的设置：

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

2. 配置 MCP 服务器：

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

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

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

如何在 Cursor 上使用它？

在 Cursor 上打开 Agentic 聊天，然后开始提出与我们的数据库相关的问题，它将拥有所有上下文

安全最佳实践

1. 使用环境变量存储敏感凭据：

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

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

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

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

许可证

此 MCP 服务器已获得 MIT 许可证的许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。