MCP Server for MySQL based on NodeJS

MCP Server for MySQL based on NodeJS

这是一个提供对MySQL数据库只读访问的模型上下文协议服务器。该服务器使LLM能够检查数据库模式并执行只读查询。

概述

MCP Server for MySQL 是一个基于 NodeJS 的服务,允许 LLM(大型语言模型)通过 Model Context Protocol 检查 MySQL 数据库模式并执行只读查询。

演示

安装选项

选项 1: 使用 Smithery (推荐)

npx -y @smithery/cli@latest install @benborla29/mcp-server-mysql --client claude

选项 2: 使用 MCP Get

npx @michaellatman/mcp-get@latest install @benborla29/mcp-server-mysql

选项 3: 使用 NPM/PNPM

# 使用 npm
npm install -g @benborla29/mcp-server-mysql

# 或使用 pnpm
pnpm add -g @benborla29/mcp-server-mysql

配置

自动配置 (Smithery)

安装过程中会提示输入 MySQL 连接详细信息,并自动配置您的环境。

手动配置

claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@benborla29/mcp-server-mysql"
      ],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "",
        "MYSQL_DB": "db_name"
      }
    }
  }
}

核心环境变量

变量描述默认值
MYSQL_HOST数据库服务器地址127.0.0.1
MYSQL_PORT数据库服务器端口3306
MYSQL_USER数据库用户名root
MYSQL_PASS数据库密码-
MYSQL_DB目标数据库名称-

功能

  • mysql_query 工具:执行只读 SQL 查询
  • 表模式:自动提供数据库表结构信息
  • 安全特性:SQL 注入防护、只读事务限制等
  • 性能优化:连接池、查询缓存、结果分页

故障排除

使用 Smithery 进行诊断:

smithery status @benborla29/mcp-server-mysql
smithery logs @benborla29/mcp-server-mysql

更多信息

完整文档请访问 Smithery