Simple MCP MySQL Server

简易 MCP MySQL 服务

一个轻量级的模型上下文协议（MCP）服务，可安全地与 MySQL 数据库交互。此服务允许 Claude 等 AI 助手通过受控接口列出表、读取数据并执行 SQL 查询。

功能

• 列出数据库中的所有 MySQL 表
• 获取所有表的详细架构信息
• 执行只读 SQL 查询，并妥善处理错误
• 通过环境变量安全地访问数据库
• 配置和部署简单

安装

# Clone the repository
git clone [email protected]:alexcc4/mcp-mysql-server.git
cd mysql-mcp-server

# Install dependencies using uv (recommended)
uv sync

配置

设置以下环境变量：

• export DB_HOST=localhost # 数据库主机
• export DB_PORT=3306 # 数据库端口（未指定时默认为 3306）
• export DB_USER=your_username # 数据库用户名
• export DB_PASSWORD=your_password # 数据库密码
• export DB_NAME=your_database # 数据库名称

用法

手动启动

uv run main.py

使用 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件中：

Mac 上的 Claude Desktop 配置文件：~/Library/Application Support/Claude/claude_desktop_config.json（如果不存在，请创建）

{
    "mcpServers": {
        "sql": {
            "command": "/path/uv",
            "args": [
                "--directory",
                "code_path",
                "run",
                "main.py"
            ],
            "env": {
                "DB_HOST": "127.0.0.1",
                "DB_PORT": "3306",
                "DB_USER": "your_user",
                "DB_PASSWORD": "your_password",
                "DB_NAME": "your_database"
           }
        }
    }
}

示例查询

配置完成后，你可以向 Claude 提出以下问题：

"Show me all tables in the database"
"Top 10 rows from users table"
"Find all orders placed in the last 30 days"
"Count of users by country"
"Show me the schema of the products table"

可用资源

该服务提供以下资源：

• mysql://schema - 完整的数据库结构信息，包括所有表和列
• mysql://tables - 数据库中所有表的列表

可用工具

该服务提供以下工具：

• query_data - 执行只读 SQL 查询并返回结果

要求

• uv（推荐）
• Python 3.12.2+
• MySQL 服务

安全注意事项

• 使用仅具有最低必要权限（只读）的数据库用户
• 切勿在生产环境中使用 root 凭据
• 对敏感数据库，可考虑实施查询白名单
• 监控并记录所有数据库操作

许可证

MIT

参考资料

• 官方文档
• PostgresSQL 示例