MySQL MCP 服务器

MySQL MCP 服务器

site icon
2025.04.23 0
JavaScript数据库访问MySQL管理数据库
MySQL MCP服务器是一个提供对MySQL数据库只读访问的服务。它允许用户列出可用数据库、列出数据库中的表、描述表结构(包含字段备注)以及执行只读SQL查询。该服务适用于需要安全访问MySQL数据库信息的场景,如数据分析、报表生成等。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP服务器是一个专门为MySQL数据库提供只读访问的中间件服务。

核心功能

  • 列出可用数据库
  • 列出数据库中的表
  • 描述表结构(包含字段备注)
  • 执行只读SQL查询

适用场景

  • 数据分析
  • 报表生成
  • 数据库结构查看
  • 只读数据访问

工具列表

  1. list_databases:列出MySQL服务器上所有可访问的数据库。
  2. list_tables:列出指定数据库中的所有表。
  3. describe_table:显示指定表的详细结构。
  4. execute_query:执行只读SQL查询。

使用教程

使用依赖

  • Node.js环境
  • npm包管理器

安装教程

  1. 从NPM安装
# 全局安装
npm install -g @valuprosys/mysql-mcp-server

# 或在项目中本地安装
npm install @valuprosys/mysql-mcp-server
  1. 配置环境变量 服务器需要以下环境变量:
  2. MYSQL_HOST: 数据库服务器地址
  3. MYSQL_PORT: 数据库端口 (默认: 3306)
  4. MYSQL_USER: 数据库用户名
  5. MYSQL_PASSWORD: 数据库密码
  6. MYSQL_DATABASE: 默认数据库名 (可选)

  7. 添加到MCP配置 在MCP配置文件中添加以下配置:

{
  "mcpServers": {
    "mysql": {
      "command": "npx",
      "args": ["@valuprosys/mysql-mcp-server"],
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-default-database"
      },
      "disabled": false,
      "autoApprove": [
        "list_databases",
        "list_tables",
        "describe_table",
        "execute_query"
      ]
    }
  }
}

调试方式

安装完成后,可以通过以下命令测试服务是否正常运行:

npx @valuprosys/mysql-mcp-server

确保环境变量已正确设置,并且可以连接到MySQL数据库。

许可证

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