MySQL MCP Server

MySQL MCP Server

site icon
2025.03.24 0
PHP数据库服务安全访问数据库
MySQL MCP Server 是一个基于模型上下文协议(MCP)的服务,旨在提供与MySQL数据库的安全交互。该服务器允许AI助手通过受控接口列出表、读取数据并执行SQL查询,使数据库探索和分析更加安全和结构化。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP Server 是一个专门为MySQL数据库设计的MCP服务器,提供安全的数据库交互能力。

核心功能

  • 列出可用的MySQL表作为资源
  • 读取表内容
  • 执行SQL查询并提供适当的错误处理
  • 通过环境变量实现安全的数据库访问
  • 全面的日志记录

适用场景

  • AI助手与MySQL数据库的安全交互
  • 数据库探索和分析
  • 需要受控访问数据库的场景

工具列表

  • php bin/console: 运行独立服务器
  • docker build -t mysql-mcp-server .: 构建Docker镜像
  • docker run -i --rm mysql-mcp-server --host 127.0.0.1: 运行Docker容器

常见问题解答

  • 安全考虑: 不要提交环境变量或凭据,使用具有最小权限的数据库用户,考虑在生产环境中实现查询白名单,监控和记录所有数据库操作。
  • 最佳实践: 创建专用的MySQL用户,不使用root凭据,限制数据库访问,启用日志记录,定期进行安全审查。

使用教程

使用依赖

安装前需要确保系统已安装以下工具: - Git - Composer - Docker(可选)

安装教程

git clone https://github.com/he426100/mysql-mcp-server
cd mysql-mcp-server
composer install

配置

设置以下环境变量:

DB_HOST=localhost     # 数据库主机
DB_PORT=3306         # 可选:数据库端口(默认3306)
DB_USERNAME=your_username
DB_PASSWORD=your_password
DB_DATABASE=your_database

调试方式

作为独立服务器运行

# 安装依赖
composer install

# 运行服务器
php bin/console

使用Docker

docker build -t mysql-mcp-server .
docker run -i --rm mysql-mcp-server --host 127.0.0.1

许可证

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