mcp-server-mysql

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

特性

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

安装

使用Docker

# 构建Docker镜像
make docker

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

通过Smithery安装

要通过Smithery自动安装MySQL数据库服务器到Claude桌面：

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

使用方法

与Claude桌面结合使用

在你的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://[用户][:密码]@主机[:端口]/数据库

用你的数据库名称替换/数据库。

开发

# 初始设置
make setup

# 构建项目
make build

# 格式化代码
make format

# 运行linter
make lint

许可证

本项目发布在MIT许可证下。

安全

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

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

贡献

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