MySQL MCP Server

MySQL MCP Server

site icon
2025.04.23 0
Python数据库服务安全通信数据库
MySQL MCP Server 是一个模型上下文协议(MCP)实现,用于安全地与 MySQL 数据库进行交互。该服务组件促进了 AI 应用程序(主机/客户端)与 MySQL 数据库之间的通信,通过受控接口使数据库探索和分析更加安全和结构化。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP Server 是一个用于安全地与 MySQL 数据库交互的通信协议实现,旨在为 AI 应用程序提供结构化和安全的数据库访问接口。

核心功能

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

适用场景

  • AI 应用程序需要与 MySQL 数据库进行安全交互
  • 需要结构化和受控的数据库访问接口
  • 数据库探索和分析

工具列表

  • MCP Inspector:用于测试和调试 MCP 实现的工具

常见问题解答

  • Q: MySQL MCP Server 是否可以独立运行? A: 不可以,它设计为与 AI 应用程序(如 Claude Desktop)集成使用,不应作为独立的 Python 程序运行。
  • Q: 如何确保数据库访问的安全性? A: 遵循最小权限原则,创建专用 MySQL 用户,限制数据库访问权限,并启用日志记录。

使用教程

使用依赖

安装 MySQL MCP Server 前需要确保已安装 Python 和 pip。

安装教程

手动安装

pip install mysql-mcp-server

通过 Smithery 安装

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

配置

设置以下环境变量:

MYSQL_HOST=localhost     # 数据库主机
MYSQL_PORT=3306         # 可选:数据库端口(默认为 3306)
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

调试方式

使用 MCP Inspector 进行调试:

# 安装依赖
pip install -r requirements.txt
# 使用 MCP Inspector 进行调试

开发

# 克隆仓库
git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # 或在 Windows 上使用 `venv\Scripts\activate`
# 安装开发依赖
pip install -r requirements-dev.txt
# 运行测试
pytest

许可证

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