MCP Server for MySQL based on NodeJS
2025.04.03
250
TypeScript数据库服务SQL查询工具数据库
MCP Server for MySQL 是一个基于NodeJS的模型上下文协议服务器，专门用于提供对MySQL数据库的访问。该服务器使大型语言模型（LLMs）能够检查数据库模式并执行SQL查询。它支持多种安装和配置方式，包括通过Claude Desktop、Cursor IDE、Smithery、MCP Get以及直接从本地仓库运行。服务器提供了丰富的功能，包括执行SQL查询、数据库模式检查、安全特性、性能优化以及监控和调试工具。
View on GitHub
Overview
基本能力
产品定位
MCP Server for MySQL 是一个专为MySQL数据库设计的模型上下文协议服务器，旨在为大型语言模型（LLMs）提供数据库访问能力，使其能够执行SQL查询和检查数据库模式。
核心功能
- 数据库访问：执行SQL查询，支持READ ONLY操作，可选写操作（INSERT, UPDATE, DELETE）。
- 安全特性：SQL注入预防、查询白名单/黑名单、速率限制、连接加密等。
- 性能优化：连接池优化、查询结果缓存、大结果集流式传输等。
- 监控和调试：全面的查询日志、性能指标收集、错误跟踪等。
- 多数据库模式：支持连接到多个数据库，支持模式特定的权限控制。
适用场景
- 开发环境：在开发过程中快速查询和检查数据库模式。
- 数据分析：执行复杂的数据分析查询。
- 自动化测试：在自动化测试中执行数据库操作。
- 教育与研究：用于数据库相关的教育和研究项目。
工具列表
- mysql_query：执行SQL查询，支持READ ONLY操作，可选写操作。
常见问题解答
- 连接问题：检查MySQL服务器是否运行，确认凭据和权限。
- 性能问题：调整连接池大小，配置查询超时值。
- 安全限制：检查速率限制配置，确认SSL/TLS设置。
- 路径解析：确保正确设置PATH和NODE_PATH环境变量。
- 认证问题：确保MySQL用户配置了正确的认证方法。
使用教程
使用依赖
- Node.js v18或更高版本
- MySQL 5.7或更高版本（推荐MySQL 8.0+）
- 具有适当权限的MySQL用户
安装教程
通过Smithery安装
npx -y @smithery/cli@latest install @benborla29/mcp-server-mysql --client claude
通过MCP Get安装
npx @michaellatman/mcp-get@latest install @benborla29/mcp-server-mysql
通过NPM/PNPM安装
# 使用npm
npm install -g @benborla29/mcp-server-mysql
# 使用pnpm
pnpm add -g @benborla29/mcp-server-mysql
从本地仓库运行
- 克隆仓库
git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql
- 安装依赖
npm install
# 或
pnpm install
- 构建项目
npm run build
# 或
pnpm run build
- 配置Claude Desktop
- 测试服务器
node dist/index.js
调试方式
- 检查MySQL服务器是否运行
- 确认凭据和权限
- 检查SSL/TLS配置
- 尝试使用MySQL客户端连接确认访问
- 查看日志文件
~/Library/Logs/Claude/mcp-server-mcp_server_mysql.log