MySQL MCP Server

MySQL MCP Server

site icon
2025.04.01 1
TypeScript数据库服务数据库
MySQL MCP Server是一个基于Model Context Protocol (MCP)的MySQL服务器,允许通过MCP协议执行SQL查询。它提供了执行SQL查询、检查数据库连接状态以及内置SQL查询示例提示等功能。适用于需要通过MCP协议与MySQL数据库交互的场景。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP Server是一个基于MCP协议的MySQL服务器,旨在通过MCP协议提供MySQL数据库的交互能力。

核心功能

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

适用场景

  • 需要通过MCP协议与MySQL数据库交互的应用
  • 需要远程执行SQL查询的场景
  • 数据库连接状态监控

工具列表

  • execute_sql: 执行SQL查询
  • check_connection: 检查数据库连接状态
  • sql_example: 提供SQL查询示例

使用教程

使用依赖

  1. 确保已安装Node.js和npm
  2. 确保已安装Git

安装教程

# 克隆仓库
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"
      }
    }
  }
}

调试方式

  1. 确保MySQL服务正在运行
  2. 检查环境变量是否正确设置
  3. 运行服务器后,尝试使用提供的工具进行测试
  4. 查看控制台输出以获取错误信息

许可证

该项目遵循 MIT 开源许可条款。