🚀 MCP 服务器 - MySQL 版本

本项目是 MCP 服务器的 MySQL 版本，为用户提供了便捷的数据库操作服务。支持多种数据库操作，具备高可用性和安全防护功能，能有效提升性能和稳定性。

🚀 快速开始

安装步骤

使用 npm 安装

可以通过以下命令轻松安装 mcp-server-mysql：

npm install -y @benborla29/mcp-server-mysql dotenv

或者使用 pnpm：

pnpm add -g @benborla29/mcp-server-mysql dotenv

使用 Docker 部署（推荐）

如果你更喜欢使用 Docker，可以参考以下命令：

1. 拉取镜像：

docker pull benborla29/mcp-server-mysql:latest

2. 启动容器：

docker run -d --name mcp-mysql -p 3001:3001 -e MYSQL_HOST=127.0.0.1 -e MYSQL_PORT=3306 -e MYSQL_USER=root -e MYSQL_PASS=your_password -e MYSQL_DB=your_database benborla29/mcp-server-mysql:latest

配置指南

创建配置文件

在项目的根目录下创建一个 .env 文件，内容如下：

MYSQL_HOST=127.0.0.1
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASS=your_password
MYSQL_DB=your_database

启动服务器

运行以下命令启动 MCP 服务器：

node index.js

✨ 主要特性

• 支持多种数据库操作：包括查询、插入、更新和删除。
• 高可用性设计：内置连接池，提升性能和稳定性。
• 安全防护：提供访问控制和日志记录功能。

📚 详细文档

常见问题解答

1. 连接问题

• 确保 MySQL 服务已启动且运行正常。
• 检查提供的凭据是否正确无误。
• 验证 SSL/TLS 配置，若启用的话。
• 尝试使用 MySQL 客户端工具连接，以确认访问权限。

2. 性能问题

• 调整连接池大小参数。
• 设定合适的查询超时值。
• 启用查询缓存功能（如有需要）。
• 监控服务器资源利用率。

3. 安全限制

• 审查速率限制配置。
• 检查查询黑白名单设置。
• 确保 SSL/TLS 配置无误。
• 确认 MySQL 用户拥有适当的权限。

贡献指南

欢迎社区贡献！请访问 GitHub 仓库 提交 Pull Request。

开发环境搭建

1. 克隆代码库：

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

2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm run build

4. 运行测试：

pnpm test

项目路线图

我们正在积极开发 MCP 服务器，以下是未来计划的功能更新：

• 支持预处理语句的高级查询功能。
• 提供更强大的安全特性。
• 实现性能优化。
• 增强监控功能。
• 扩展模式信息支持。

如需贡献或讨论新功能，请在 GitHub 仓库 中提交 Issues 或 Pull Request。

希望这份指南能帮助你顺利安装和使用 MCP 服务器 - MySQL 版本。如果有任何问题，欢迎随时联系项目维护人员！