MySQL MCP Server

MySQL MCP Server

site icon
2025.03.30 0
数据库服务AI 数据库交互数据库
MySQL MCP Server 是一个实现 Model Context Protocol (MCP) 的服务器组件,旨在为 AI 应用程序与 MySQL 数据库之间提供安全的交互接口。它通过受控的协议实现,使数据库的探索和分析更加安全和结构化。该服务器不是作为独立服务器使用,而是作为 AI 应用程序与 MySQL 数据库之间的通信协议实现。
View on GitHub

Overview

基本能力

产品定位

MySQL MCP Server 是一个专门为 AI 应用程序设计的 MySQL 数据库交互协议实现,提供安全、结构化的数据库访问方式。

核心功能

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

适用场景

  • AI 应用程序需要与 MySQL 数据库交互的场景
  • 需要安全、结构化访问数据库的项目
  • 数据库探索和分析任务

工具列表

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

常见问题解答

  • 安全性问题:建议创建专用的 MySQL 用户,并遵循最小权限原则
  • 运行方式:不应作为独立 Python 程序运行,而是集成到 AI 应用程序中

使用教程

使用依赖

无特殊依赖,直接安装即可。

安装教程

手动安装

pip install mysql-mcp-server

通过 Smithery 安装

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

配置

设置以下环境变量:

MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=your_username
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=your_database

调试方式

使用 MCP Inspector 进行调试:

pip install -r requirements.txt

开发

git clone https://github.com/yourusername/mysql_mcp_server.git
cd mysql_mcp_server
python -m venv venv
source venv/bin/activate
pip install -r requirements-dev.txt
pytest

许可证

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