v4.0.0 - 全新架构重写，更简洁、更强大！

一个功能强大且易用的 MySQL 数据库 MCP（Model Context Protocol）服务器，支持 AI 助手安全地操作 MySQL 数据库。

🌟 核心特性

• 🌐 StreamableHTTP 协议 - 基于最新 MCP 规范实现
• 🔐 Header 预配置 - 凭证不暴露给 AI，安全可靠
• 🤖 AI 动态管理 - AI 可以帮你添加/切换数据库连接
• 🔗 多数据库支持 - 同时管理多个数据库，随时切换
• 📊 完整 CRUD - 支持所有 SQL 操作
• 🏗️ 模块化架构 - 清晰的目录结构，易于扩展

---

📦 安装

环境要求

• Node.js 18+
• MySQL 5.7+ 或 8.0+
• MCP 客户端（Claude Desktop、Cursor 等）

安装步骤

---

⚙️ 配置方法

方式一：Header 预配置（推荐）

编辑 MCP 配置文件：

Windows： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Linux：~/.config/Claude/claude_desktop_config.json

单数据库配置

多数据库配置

优势：

• ✅ 数据库凭证不暴露给 AI
• ✅ 启动即连接，无需手动操作
• ✅ 支持多数据库同时连接

方式二：AI 动态添加（灵活）

不配置 Header，让 AI 在对话中帮你添加连接：

使用示例：

---

🔧 工具列表

连接管理

查询操作

MySQL MCP Server 🚀

v4.0.0 - 全新架构重写，更简洁、更强大！

一个功能强大且易用的 MySQL 数据库 MCP（Model Context Protocol）服务器，支持 AI 助手安全地操作 MySQL 数据库。

🌟 核心特性

• 🌐 StreamableHTTP 协议 - 基于最新 MCP 规范实现
• 🔐 Header 预配置 - 凭证不暴露给 AI，安全可靠
• 🤖 AI 动态管理 - AI 可以帮你添加/切换数据库连接
• 🔗 多数据库支持 - 同时管理多个数据库，随时切换
• 📊 完整 CRUD - 支持所有 SQL 操作
• 🏗️ 模块化架构 - 清晰的目录结构，易于扩展

---

📦 安装

环境要求

• Node.js 18+
• MySQL 5.7+ 或 8.0+
• MCP 客户端（Claude Desktop、Cursor 等）

安装步骤

# 克隆项目
git clone https://github.com/guangxiangdebizi/MySQL_MCP.git
cd MySQL_MCP

# 安装依赖
npm install

# 编译
npm run build

# 启动服务器
npm start

---

⚙️ 配置方法

方式一：Header 预配置（推荐）

编辑 MCP 配置文件：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

单数据库配置

{
  "mcpServers": {
    "mysql-mcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "timeout": 600,
      "headers": {
        "X-MySQL-Host": "localhost",
        "X-MySQL-Port": "3306",
        "X-MySQL-User": "root",
        "X-MySQL-Password": "your_password",
        "X-MySQL-Database": "your_database"
      }
    }
  }
}

多数据库配置

{
  "mcpServers": {
    "mysql-mcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "timeout": 600,
      "headers": {
        "X-MySQL-Host-1": "prod.mysql.com",
        "X-MySQL-User-1": "prod_user",
        "X-MySQL-Password-1": "prod_pass",
        "X-MySQL-Database-1": "production",
        
        "X-MySQL-Host-2": "test.mysql.com",
        "X-MySQL-User-2": "test_user",
        "X-MySQL-Password-2": "test_pass",
        "X-MySQL-Database-2": "testing"
      }
    }
  }
}

优势：

• ✅ 数据库凭证不暴露给 AI
• ✅ 启动即连接，无需手动操作
• ✅ 支持多数据库同时连接

方式二：AI 动态添加（灵活）

不配置 Header，让 AI 在对话中帮你添加连接：

{
  "mcpServers": {
    "mysql-mcp": {
      "type": "streamableHttp",
      "url": "http://localhost:3001/mcp",
      "timeout": 600
    }
  }
}

使用示例：

你: 帮我连接到本地 MySQL，用户名 root，密码 123456，数据库 mydb
AI: [调用 add_connection 工具]

---

🔧 工具列表

连接管理

查询操作

---

🎮 使用示例

场景一：使用 Header 预配置

你: 显示所有表
AI: [调用 show_tables] 
    📊 数据库表列表 (共 5 个表)
    1. users
    2. orders
    3. products
    ...

你: 查看 users 表的结构
AI: [调用 describe_table，参数：users]
    📋 表结构: users
    字段信息:
    - id (INT, 主键)
    - name (VARCHAR)
    - email (VARCHAR)
    ...