mcp-server-mysql

用于 MySQL 数据库的模型上下文协议服务器。 此服务器使 LLM 能够检查数据库模式并执行只读查询。

特性

• 对 MySQL 数据库的只读访问
• 模式检查功能
• 在 READ ONLY 事务中安全地执行查询
• Docker 支持
• 提供 NPM 包

安装

使用 Docker

# 构建 Docker 镜像
make docker

# 使用 Docker 运行
docker run -i --rm mcp/mysql mysql://host:port/dbname

使用 NPM

npm install @modelcontextprotocol/server-mysql

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MySQL 数据库服务器：

npx -y @smithery/cli install @yuru-sha/mcp-server-mysql --client claude

用法

与 Claude Desktop 一起使用

将以下配置添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "mysql": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/mysql",
        "mysql://host:port/dbname"
      ]
    }
  }
}

注意：在 macOS 上使用 Docker 时，如果 MySQL 服务器在主机网络上运行，请使用 host.docker.internal。

连接 URL 格式

mysql://[user][:password]@host[:port]/database

将 /database 替换为您的数据库名称。

开发

# 初始设置
make setup

# 构建项目
make build

# 格式化代码
make format

# 运行 linter
make lint

许可证

本项目根据 MIT 许可证 发布。

安全

此服务器强制执行只读访问以保护您的数据库。 所有查询都在 READ ONLY 事务中执行。

为了增强安全性，我们建议创建一个只读用户。

贡献

欢迎贡献！ 请随时提交 Pull Request。