MCP Server for MySQL based on NodeJS

基本能力

产品定位

MCP Server for MySQL 是一个数据库访问中间件，旨在为大型语言模型提供安全、高效的MySQL数据库操作能力。

核心功能

• 数据库查询：执行SQL查询并返回结果
• 模式检查：提供数据库表结构和关系的详细信息
• 安全控制：支持细粒度的权限控制（读/写操作）
• 性能优化：连接池、查询缓存和结果流式传输
• 多数据库支持：可同时访问多个MySQL数据库

适用场景

• 需要让LLM访问结构化数据的应用
• 数据库管理辅助工具
• 数据分析和报告生成
• 数据库模式设计和优化

工具列表

• mysql_query：执行SQL查询工具
• 支持SELECT查询（默认）
• 可选支持INSERT/UPDATE/DELETE（需配置）
• 支持事务处理
• 提供查询统计信息

常见问题解答

1. 连接问题：检查MySQL服务是否运行，确认凭据正确
2. 性能问题：调整连接池大小和查询超时设置
3. 权限问题：确保MySQL用户有适当权限
4. 路径问题：需要正确设置Node.js路径
5. 认证问题：MySQL 8.0+可能需要特殊认证配置

使用教程

使用依赖

• Node.js v18或更高版本
• MySQL 5.7或更高版本（推荐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

从本地仓库运行

1. 克隆仓库

git clone https://github.com/benborla/mcp-server-mysql.git
cd mcp-server-mysql

1. 安装依赖

npm install
# 或
pnpm install

1. 构建项目

npm run build
# 或
pnpm run build

调试方式

1. 直接运行服务器测试

node dist/index.js

1. 检查日志文件

~/Library/Logs/Claude/mcp-server-mcp_server_mysql.log

1. 测试数据库连接

# 使用测试脚本
pnpm run setup:test:db
pnpm test

许可证

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