MySQL MCP服务器

一个基于FastMCP 2.0和Python实现的MySQL模型上下文协议(MCP)服务器,提供SQL查询执行、数据库架构信息获取等功能,支持Docker容器化部署。

  • by ganganbiz1
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 ganganbiz1/mysql-mcp-server

使用说明

MySQL MCP服务器

使用FastMCP 2.0和Python实现的MySQL模型上下文协议(MCP)服务器。

特性

  • 通过MCP函数执行SQL查询
  • 获取数据库架构信息
  • 完全容器化使用Docker和Docker compose
  • 与Poetry打包用于依赖关系管理

MCP工具

服务器提供以下MCP工具:

  • execute_query:执行SQL查询并返回结果
  • execute_update:执行更新/插入SQL查询
  • get_tables:获取数据库中的表列表
  • get_table_schema:获取特定表的架构信息
  • describe_database:获取全面的数据库结构信息

设置

先决条件

  • Docker和Docker组合
  • 诗歌(促进地方发展)
  • Python 3.13+

光标集成

要与Cursor集成,请将以下内容添加到您的 ~/.cursor/mcp.json 文件:

{
  "mcpServers": {
    "mysqlMcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MYSQL_HOST",
        "-e",
        "MYSQL_PORT",
        "-e",
        "MYSQL_USER",
        "-e",
        "MYSQL_PASSWORD",
        "-e",
        "MYSQL_DATABASE",
        "mysql-mcp-server"
      ],
      "env": {
        "MYSQL_HOST": "host.docker.internal",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "password",
        "MYSQL_DATABASE": "mcpdb"
      }
    }
  }
}

Docker构建

要单独构建Docker镜像:

docker build -t mysql-mcp-server .