MySQL MCP 服务器安装配置最佳实践_Mysql

mysql mcp 服务器安装配置指南

简介

模型上下文协议（mcp）的mysql实现，提供ai应用与mysql数据库之间的安全交互能力。该服务器组件作为中间层，通过结构化接口使ai应用能够安全地进行数据库探索与分析。

注意：mysql mcp服务器不是独立服务器，而是ai应用与mysql数据库之间的通信协议实现。

功能特点

数据库交互：列出表资源、读取表内容、执行sql查询
安全机制：通过环境变量安全访问数据库，错误处理机制
可扩展性：支持多种集成方式（claude desktop、vs code、cursor）
日志记录：完善的操作日志，便于审计和调试

安装方法

通过pip安装

pip install mysql-mcp-server

通过smithery安装（推荐）

为claude desktop自动安装：

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

数据库配置

环境变量设置

# 必填项
mysql_host=localhost     # 数据库主机地址
mysql_user=your_username # 数据库用户名
mysql_password=your_password # 数据库密码
mysql_database=your_database # 数据库名称
# 可选项
mysql_port=3306         # 数据库端口，默认为3306

使用方法

与claude desktop集成

在claude_desktop_config.json中添加：

{
  "mcpservers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mysql_mcp_server",
        "run",
        "mysql_mcp_server"
      ],
      "env": {
        "mysql_host": "localhost",
        "mysql_port": "3306",
        "mysql_user": "your_username",
        "mysql_password": "your_password",
        "mysql_database": "your_database"
      }
    }
  }
}

与visual studio code集成

在mcp.json中添加：

{
  "servers": {
    "mysql": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mysql-mcp-server",
        "mysql_mcp_server"
      ],
      "env": {
        "mysql_host": "localhost",
        "mysql_port": "3306",
        "mysql_user": "your_username",
        "mysql_password": "your_password",
        "mysql_database": "your_database"
      }
    }
  }
}

提示：集成前需确保已安装uv包管理器

与cursor集成

在cursor设置中配置mysql mcp服务器：

{
  "mcp": {
    "servers": {
      "mysql": {
        "command": "python",
        "args": [
          "-m",
          "mysql_mcp_server"
        ],
        "env": {
          "mysql_host": "localhost",
          "mysql_port": "3306",
          "mysql_user": "your_username",
          "mysql_password": "your_password",
          "mysql_database": "your_database"
        }
      }
    }
  }
}

注意：确保cursor已启用mcp功能，并且mysql mcp服务器包已正确安装在当前python环境中。

使用mcp inspector进行调试

虽然mysql mcp server不适合直接运行，但您可以使用mcp inspector进行测试和调试：

# 安装依赖
pip install -r requirements.txt
# 使用mcp inspector调试
mcp-inspector mysql_mcp_server

开发指南

# 克隆仓库
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # windows使用: venv\scripts\activate
# 安装开发依赖
pip install -r requirements-dev.txt
# 运行测试
pytest

安全最佳实践

数据库权限

创建专用用户：为mcp服务器创建具有最小权限的专用mysql用户
避免使用root：永远不要使用root账户或管理员权限
权限限制：仅授予必要的操作权限（select、特定表的insert等）

配置安全

环境变量保护：不要在代码或公共仓库中提交环境变量或凭证
查询限制：考虑在生产环境中实施查询白名单
日志审计：启用详细日志记录以供安全审计

监控与审查

定期审查：定期检查数据库访问日志
性能监控：监控查询性能和资源使用
安全更新：及时应用安全补丁和更新

重要提示：始终遵循最小权限原则配置数据库访问。

故障排除

问题	解决方案
连接错误	检查环境变量配置和网络连接
权限拒绝	验证数据库用户权限设置
性能问题	监控查询复杂度，考虑添加索引
cursor集成问题	确保在设置中正确启用了mcp