MySQL MCP Server

MySQL MCP Server

site icon
2025.04.03 3
TypeScript数据库连接AI 数据库交互数据库
MySQL MCP Server 是一个遵循 Model Context Protocol (MCP) 规范的服务器,旨在为 AI 模型与 MySQL 数据库之间提供结构化的交互接口。它支持通过 Web 服务器和 CLI 模式操作,使 AI 代理能够查询和分析 MySQL 数据。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP Server 是一个桥梁工具,专门设计用于连接 AI 模型与 MySQL 数据库,提供结构化的数据交互能力。

核心功能

  • MySQL 数据库连接管理
  • SQL 查询执行
  • 表列表和结构检查
  • 数据库列表和选择
  • 通过 SSE (Server-Sent Events) 实时状态监控
  • 提供 Web 界面测试 MCP 工具
  • 支持 stdio 和 SSE 传输方法
  • 支持 Docker 部署

适用场景

  • AI 模型需要访问和操作 MySQL 数据库的场景
  • 需要实时监控数据库状态的 AI 应用
  • 开发者在本地或云端快速搭建 MySQL 与 AI 交互的桥梁

工具列表

  1. status: 检查当前数据库连接状态。
  2. connect: 连接到 MySQL 数据库。
  3. disconnect: 关闭当前 MySQL 数据库连接。
  4. query: 在连接的数据库上执行 SQL 查询。
  5. list_tables: 获取当前数据库中的表列表。
  6. describe_table: 获取特定表的结构。
  7. list_databases: 获取服务器上所有可访问的数据库列表。
  8. use_database: 切换到不同的数据库。

常见问题解答

  • 如何配置数据库连接? 通过设置环境变量:MYSQL_HOST, MYSQL_PORT, MYSQL_USER, MYSQL_PASSWORD, MYSQL_DATABASE, 和可选的 MYSQL_READONLY。
  • 支持哪些 AI 平台? Anthropic Claude, Cursor AI, Windsurf, Cline, Witsy, Enconvo, Goose。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# 全局安装
npm install -g mysql-mcp

# 本地安装
npm install mysql-mcp

调试方式

  1. 运行 npm link 在项目目录中。
  2. 配置设置文件如下:
{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": ["mysql-mcp"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database",
        "MYSQL_READONLY": "true"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。