返回 MCP 目录
public公开dns本地运行

mysql-mcp-server-a92

一个基于MCP协议的MySQL服务器,支持通过MCP执行SQL查询和检查数据库连接

article

README

🚀 MySQL MCP 服务器

MySQL MCP 服务器是一个基于模型上下文协议(MCP)的服务器,它允许用户通过 MCP 协议执行 SQL 查询,为数据库操作提供了便捷的途径。

🚀 快速开始

本服务器允许通过 MCP 协议执行 SQL 查询,还能检查数据库连接状态,并且内置了 SQL 查询示例提示,方便用户使用。

✨ 主要特性

  • 通过 MCP 协议执行 SQL 查询。
  • 检查数据库连接状态。
  • 内置 SQL 查询示例提示。

📦 安装指南

# 克隆仓库
git clone https://github.com/shengshengshengbuxi/mysql_mcp_server.git
cd mysql_mcp_server

# 安装依赖
npm install

# 编译 TypeScript 代码
npm run build

📚 详细文档

配置

服务器使用以下环境变量进行配置: | 属性 | 详情 | |------|------| | MYSQL_HOST | MySQL 主机地址(默认: localhost) | | MYSQL_PORT | MySQL 端口(默认: 3306) | | MYSQL_USER | MySQL 用户名(默认: root) | | MYSQL_PASSWORD | MySQL 密码(默认: 空) | | MYSQL_DATABASE | MySQL 数据库名(默认: 空) |

运行

# 设置 MySQL 连接参数
$env:MYSQL_HOST = "localhost"
$env:MYSQL_PORT = "3306"
$env:MYSQL_USER = "root"
$env:MYSQL_PASSWORD = "your_password"
$env:MYSQL_DATABASE = "your_database"

# 启动服务器
npm start

与 Claude 集成

要在 Claude Desktop 中使用此服务器,请编辑 Claude Desktop 配置文件: Windows:

%USERPROFILE%\AppData\Roaming\Claude\claude_desktop_config.json

添加以下配置:

{
  "mcpServers": {
    "mysql": {
      "command": "node",
      "args": [
        "/path/to/mysql_mcp_server/dist/server.js",
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your password",
        "MYSQL_DATABASE": "your database"
      }
    }
  }
}

工具

  • execute_sql: 执行 SQL 查询。
  • check_connection: 检查数据库连接状态。

提示

  • sql_example: 提供 SQL 查询示例。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端