mcp-mysql-server

基于模型上下文协议的MySQL数据库操作服务器。此服务器使AI模型能够通过标准化接口与MySQL数据库进行交互。

安装

npx @malove86/mcp-mysql-server

配置

服务器支持两种部署模式：

1. 本地运行模式

在MCP配置文件中运行命令行：

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["-y", "@malove86/mcp-mysql-server"],
      "env": {
        "MYSQL_HOST": "your_host",
        "MYSQL_USER": "your_user",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_PORT": "3306"
      }
    }
  }
}

2. 远程URL模式（v0.2.2+）

指向远程运行的MCP服务器：

{
  "mcpServers": {
    "mcp-mysql-server": {
      "url": "http://your-server-address:port/mcp-mysql-server"
    }
  }
}

在远程服务器上，您需要设置环境变量以启动MCP服务器：

# 设置环境变量
export MYSQL_HOST=your_host
export MYSQL_USER=your_user
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
export MYSQL_PORT=3306  # 可选，默认为3306

# 启动服务器
npx @malove86/mcp-mysql-server

注意：MYVNet PORT是可选的，默认值为3306。

版本功能

V0.2.4+ 新特性

• 多用户并发支持：服务器现在可以同时处理来自多个用户的请求。
• 高效的连接池管理：使用改进的连接池，支持高达50个并发连接。
• 请求级别的隔离：每个请求都有一个唯一的标识符，便于跟踪和调试。
• 详细的日志记录：记录每个请求的执行过程和资源使用情况。
• 改进的错误处理：更准确地捕获并报告数据库错误。
• 性能优化：连接池复用和优化的连接管理提高了处理速度。

V0.2.2+ 特性

• 自动数据库连接：当服务器启动时，如果设置了环境变量，它会自动尝试连接到数据库。
• 无需客户端参数：在使用URL模式时，客户端不需要提供数据库连接信息。
• 无感知数据库操作：可以直接使用list_tables、query等工具，无需先调用connect_db。
• 更安全：敏感的数据库凭证仅存在于服务器端，并且在客户端对话中不会暴露。
• 优雅的容错机制：即使初始连接失败，后续操作也会自动重试连接。

可用工具

1. connect_db

使用提供的凭据建立与MySQL数据库的连接。如果已通过环境变量设置了连接，则此工具是可选的。

{
  "host": "localhost",
  "user": "root",
  "password": "your_password",
  "database": "your_database",
  "port": 3306  // 可选，默认为3306
}

2. query

执行SELECT查询，支持可选的预处理语句参数。

{
  "sql": "SELECT * FROM users WHERE id = ?",
  "params": [1]  // 可选参数
}

3. list_tables

列出连接数据库中的所有表。

{}  // 从v0.2.4开始不再需要任何参数

4. describe_table

获取特定表的结构。

{
  "table": "users"
}

功能

• 安全的连接处理，自动清理
• 支持预处理语句参数
• 全面的错误处理和验证
• 支持TypeScript
• 自动连接管理
• 服务器环境变量配置
• 支持URL远程连接模式
• 多用户并发支持
• 高性能连接池

性能

• 支持高达50个并发连接（可配置）
• 自动管理连接池以提高资源利用率
• 详细的请求跟踪和性能监控

安全

• 使用预处理语句防止SQL注入
• 通过环境变量支持安全密码处理
• 执行前验证查询
• 完成后自动关闭连接
• 在URL模式下，敏感凭证不会在客户端暴露
• 连接隔离以防止用户间的数据泄露

贡献

欢迎贡献！ 请随时提交Pull Request到 https://github.com/Malove86/mcp-mysql-server.git

许可证

MIT