MySQL MCP

这是一个专为 Cursor 设计的MySQL数据库 MCP (Model Context Protocol) 服务，提供表结构查询、文档生成和数据查询功能。

- Cursor 专用集成: 专为 Cursor MCP 协议设计的数据库服务
- 多种安全模式: 支持只读、限制写入、完全访问三种安全级别
- 表结构查询: 获取数据库表的详细结构信息
- 文档生成: 生成 Markdown、JSON、SQL 格式的表结构文档
- 数据库概览: 生成整个数据库的概览文档
- SQL 查询执行: 根据安全模式执行不同级别的 SQL 操作
- 查询缓存: 自动缓存查询结果，提升性能

- 仅允许 SELECT、SHOW、DESCRIBE、EXPLAIN 等查询操作
- 禁止所有写入和危险操作
- 适用于数据分析和报表查询

- 允许 SELECT、INSERT、UPDATE 操作
- 禁止 DELETE、DROP、CREATE、ALTER 等危险操作
- 适用于需要数据录入但要保护结构的场景

- 允许所有 SQL 操作
- 谨慎使用，仅在完全信任的环境中启用
- 适用于数据库管理和维护

cd mysql-mcp pip install -r requirements.txt

{ "mcpServers": { "mysql-mcp": { "command": "python", "args": ["F:/path/to/mysql-mcp/main.py"], "env": { "MYSQL_HOST": "localhost", "MYSQL_PORT": "3306", "MYSQL_USERNAME": "your_username", "MYSQL_PASSWORD": "your_password", "MYSQL_DATABASE": "your_database", "MYSQL_SECURITY_MODE": "readonly", "MYSQL_ALLOWED_SCHEMAS": "", "MYSQL_ENABLE_QUERY_LOG": "false" } } } }

- "": 允许访问所有有权限的数据库（推荐）
- "auto": 自动发现有权限的数据库
- "db1,db2,db3": 明确指定数据库列表（逗号分隔）

- 保存位置: mysql-mcp目录下的docs/文件夹
- 文件命名:{database}_{table_name}_{timestamp}.{ext}格式
- 支持格式: Markdown (.md)、JSON (.json)、SQL (.sql)

✅ 文档生成成功! 📁 保存路径: docs/mydb_users_20250110_142000.md 📂 MCP服务目录: F:/path/to/mysql-mcp 📊 表名: mydb.users 📝 格式: markdown ⏰ 生成时间: 2025-01-10 14:20:00

# 获取缓存统计信息 @mysql-mcp 获取查询缓存统计信息 # 清空缓存 @mysql-mcp 清空查询缓存

- 生产环境建议使用readonly模式
- 敏感环境中避免使用full_access模式
- 密码安全：避免在配置中使用弱密码
- 网络安全：确保数据库连接使用安全的网络通道
- 权限最小化：数据库用户只应获得必要的最小权限

- 配置错误: 检查 Cursor MCP 配置中的环境变量设置
- 连接失败: 验证数据库连接参数和网络连通性
- 权限不足: 检查数据库用户权限和安全模式设置
- SQL 被拒绝: 当前安全模式不允许执行该类型的 SQL 操作

- main.py: MCP服务主程序
- config.py: 环境变量配置模块
- database.py: 数据库操作和安全控制模块
- document_generator.py: 文档生成模块

- 多级安全模式验证
- SQL语句类型检查
- 数据库访问权限控制
- 查询结果行数限制
- 连接超时和重试机制

- 使用 mysql-connector-python 驱动连接
- 适配MySQL系统表查询语法
- 支持MySQL约束类型识别
- 适配MySQL数据类型映射

- ✅自由使用: 允许任何人免费使用、复制、修改本软件
- ✅商业友好: 支持商业使用和分发
- ✅修改自由: 可以修改源代码并发布衍生作品
- ✅最小限制: 只需保留版权声明即可

版本: 1.0.0
更新时间: 2025-01-10
设计目标: 专为MySQL数据库和 Cursor MCP 集成优化

Multi-database agent access (PostgreSQL, SQLite, MySQL, Oracle, SQL Server) with batch queries, pre-configured connections, and SQLGlot-enforced read-only safety

A read-only MCP server for MySQL, enabling LLMs to query live data using the CData JDBC Driver.

Database MCP server for MySQL, MariaDB, PostgreSQL & SQLite

A single-binary MCP server for MySQL, MariaDB, PostgreSQL, and SQLite

A Model Context Protocol (MCP) server that provides multi-database query execution capabilities with support for SQLite, PostgreSQL, and MySQL databases. Includes a built-in Web UI for managing database connections.

Allows Claude AI to interact directly with MySQL databases.

Update various databases (PostgreSQL, MySQL, MongoDB, SQLite) using data from CSV and Excel files.

Enables AI assistants to interact with various databases through JDBC connections.

An MCP server for retrieving data from a MariaDB database.

Access and manage MariaDB or MySQL databases using an MCP server.