MySQL MCP Server
2025.04.22
0
Python数据库服务MySQL 接口数据库
MySQL MCP Server 是一个基于 MCP (Model Context Protocol) 的服务器，用于与 MySQL 数据库进行交互。它提供了在 WSL 环境中访问 MySQL 数据库的接口，支持多种数据库操作，包括表列表获取、数据读取和 SQL 查询执行。
View on GitHub
Overview
基本能力
产品定位
MySQL MCP Server 是一个基于 MCP (Model Context Protocol) 的服务器，用于与 MySQL 数据库进行交互。它提供了在 WSL 环境中访问 MySQL 数据库的接口。
核心功能
- MySQL 数据库内表列表的获取
- 表数据读取（最多 100 行）
- SQL 查询执行（SELECT、SHOW TABLES、INSERT、UPDATE、DELETE 等）
适用场景
- 在 WSL 环境中访问 MySQL 数据库
- 执行基本的 SQL 查询操作
- 数据库表结构和数据的快速查看
工具列表
sql_tools.py: 提供 SQL 查询执行功能
常见问题解答
- WSL 环境中 MySQL 服务器连接问题
- 数据库权限配置问题
- 环境变量设置问题
使用教程
使用依赖
- Python 3.11 以上
- MySQL 服务器（本地或远程）
- 虚拟环境（virtualenv）
- Docker（可选）
安装教程
- 克隆仓库：
bash git clone <repository-url> cd mysql_mcp_server - 创建并激活虚拟环境：
bash python -m venv .venv source .venv/bin/activate # Linux - 安装依赖：
bash pip install -r requirements.txt . - 设置脚本权限并执行：
bash chmod +x setup.sh ./setup.sh
调试方式
- 直接运行：
bash ./run_direct.sh - 作为模块运行：
bash ./run_module.sh - 使用 Docker 运行：
bash docker build -t mysql-mcp-server:latest . ./run_docker.sh
测试
- 运行所有测试：
bash nox -s test - 直接运行测试：
bash pytest tests/ - 检查代码覆盖率：
bash pytest --cov=src.mysql_mcp_server tests/