Mysql-工具-MCP

@C9lluck/Mysql-tool-MCP

0 Stars 1.1k 次浏览 C9lluck 更新于 2026-08-23

这是一个基于FastMCP框架开发的MySQL数据库查询服务器，提供简单易用的数据库操作接口。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mysql": {
      "args": [
        "--directory",
        "Mysql",
        "run",
        "Mysql.py"
      ],
      "command": "uv",
      "env": {
        "MYSQL_CHARSET": "utf8mb4",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_HOST": "localhost",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root"
      }
    }
  }
}

该服务需要配置环境变量：MYSQL_CHARSET、MYSQL_DATABASE、MYSQL_HOST、MYSQL_PASSWORD、MYSQL_PORT、MYSQL_USER

服务介绍

MySQL MCP 服务器

这是一个基于FastMCP框架开发的MySQL数据库查询服务器，提供简单易用的数据库操作接口。

功能特点

支持SQL查询和更新操作
使用环境变量进行数据库配置
提供异常处理和错误日志
支持参数化查询，防止SQL注入

环境要求

Python >= 3.10
uv包管理器

依赖库

fastmcp >= 2.3.3
pymysql >= 1.1.1

安装步骤

确保已安装uv包管理器
克隆项目到本地
在项目根目录执行：
```
uv init
uv add fastmcp
uv add pymysql
```

配置说明

在项目根目录创建.env文件，配置以下环境变量：

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database
MYSQL_CHARSET=utf8mb4

使用方法

启动服务器

python Mysql.py

可用工具函数

query - 执行SQL查询

# 示例
query("SELECT * FROM users WHERE age > ?", [18])

execute - 执行SQL更新操作

# 示例
execute("UPDATE users SET name = ? WHERE id = ?", ["新名字", 1])

MCP配置

在MCP配置文件中添加以下配置：

{
  "mcpServers": {
    "mysql": {
      "command": "uv",
      "args": [
        "--directory",
        "Mysql",
        "run",
        "Mysql.py"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_CHARSET": "utf8mb4"
      }
    }
  }
}

配置说明：

command: 使用uv包管理器运行Python脚本
args: 运行参数配置
- --directory: 指定运行目录
- run: 运行Python脚本
env: 环境变量配置，与.env文件中的配置对应

注意事项

确保数据库配置正确且数据库服务器可访问
建议在生产环境中使用安全的密码存储方式
定期检查和维护数据库连接

查看源码项目主页