MySQL 查询 MCP 服务器
模型上下文协议 (MCP) 服务器，为 AI 助手提供只读MySQL 数据库查询。您可以直接使用 AI 工具执行查询、探索数据库结构并调查数据。
支持的AI工具
该 MCP 服务器可与任何支持模型上下文协议的工具配合使用，包括：
Cursor IDE : 在
.cursor/mcp.json中设置Anthropic Claude ：与兼容的 MCP 客户端一起使用
其他兼容 MCP 的 AI 助手：请遵循工具的 MCP 配置说明
Related MCP server: MCP MySQL Server
功能与限制
它的作用
✅ 执行只读MySQL 查询（仅限 SELECT、SHOW、DESCRIBE）
✅ 使用预定义环境（本地、开发、暂存、生产）
✅ 提供数据库信息和元数据
✅ 列出可用的数据库环境
✅ 支持 SSL 连接以实现安全的数据库访问
✅ 实现查询超时以防止长时间运行的操作
它不能做什么
❌执行写操作（INSERT、UPDATE、DELETE、CREATE、ALTER 等）
❌支持自定义环境名称（限于本地、开发、暂存、生产）
❌ 提供数据库设计或模式生成功能
❌ 充当完整的数据库管理工具
此工具专为通过只读查询进行数据调查和探索而设计。它不适用于数据库管理、架构管理或数据修改。
快速安装
设置说明
配置您的 AI 工具以使用 MCP 服务器
创建或编辑您的 MCP 配置文件（例如，Cursor IDE 的.cursor/mcp.json ）：
基本配置：
具有数据库凭证的综合配置：
选择正确的配置方法
有两种方法可以配置 MySQL MCP 服务器：
二进制配置（
type: "bin"，bin: "mysql-query-mcp"）何时使用：当您全局安装软件包时（
npm install -g mysql-query-mcp-server）优点：配置更简单
缺点：需要全局安装
命令配置（
command: "npx"，args: ["mysql-query-mcp-server@latest"]）何时使用：当您想使用最新版本而不进行全局安装时
优点：无需全局安装，所有配置都在一个文件中
缺点：配置更复杂
选择最适合您工作流程的方法。这两种方法均可与任何支持 MCP 的 AI 助手完美兼容。
重要配置说明
您必须使用完整的环境名称：LOCAL_、DEVELOPMENT_、STAGING_、PRODUCTION_
DEV_ 或 PROD_ 等缩写不起作用
DEBUG、MCP_MYSQL_SSL 等全局设置适用于所有环境
必须配置至少一个环境（通常是“本地”）
您只需配置您计划使用的环境
出于安全原因，请考虑使用环境变量或安全凭证存储来存储生产凭证
配置选项
环境变量 | 描述 | 默认 |
调试 | 启用调试日志记录 | 错误的 |
[环境]_DB_HOST | 环境的数据库主机 | - |
[环境]_DB_USER | 数据库用户名 | - |
[环境]_DB_PASS | 数据库密码 | - |
[环境]数据库名称 | 数据库名称 | - |
[环境]_DB_PORT | 数据库端口 | 3306 |
[环境]_DB_SSL | 启用 SSL 连接 | 错误的 |
MCP_MYSQL_SSL | 为所有连接启用 SSL | 错误的 |
MCP_MYSQL_REJECT_UNAUTHORIZED | 验证 SSL 证书 | 真的 |
与人工智能助手集成
您的 AI 助手可以通过 MCP 服务器与 MySQL 数据库进行交互。以下是一些示例：
示例查询：
使用 MySQL MCP 工具
MySQL Query MCP 服务器提供了三个主要工具供您的 AI 助手使用：
1. 查询
针对特定环境执行只读 SQL 查询：
2. 信息
获取有关数据库的详细信息：
3. 环境
列出配置中所有已配置的环境：
可用工具
MySQL Query MCP 服务器提供了三个主要工具：
1. 查询
执行只读 SQL 查询：
支持的查询类型（严格限制为） ：
SELECT 语句
SHOW 命令
DESCRIBE/DESC 表
2. 信息
获取有关数据库的详细信息：
服务器版本
连接状态
数据库变量
进程列表
可用数据库
3. 环境
列出配置中所有已配置的环境：
安全注意事项
✅ 只允许只读查询（SELECT、SHOW、DESCRIBE）
✅ 每个环境都有自己独立的连接池
✅ 生产环境支持 SSL 连接
✅ 查询超时可防止失控操作
⚠️考虑使用安全凭证管理来管理数据库凭证
故障排除
连接问题
如果您在连接时遇到问题：
在 MCP 配置中验证数据库凭据
确保 MySQL 服务器正在运行并且可以访问
检查防火墙规则是否阻止连接
通过在配置中设置 DEBUG=true 来启用调试模式
常见错误
错误：环境没有可用的连接池
确保已为该环境定义了所有必需的环境变量
检查您是否正在使用受支持的环境名称之一（本地、开发、暂存、生产）
错误：查询执行失败
验证 SQL 语法
检查您是否仅使用受支持的查询类型（SELECT、SHOW、DESCRIBE）
确保您的查询确实是只读的
有关更全面的故障排除，请参阅故障排除指南。
有关如何与 AI 助手集成的示例，请参阅集成示例。
有关 MCP 协议的实现细节，请参阅MCP README 。
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
CI/CD 和发布流程
该项目使用 GitHub Actions 进行持续集成和自动发布。
CI/CD 工作流程
CI/CD 管道包括：
构建和测试：在每次推送到
main和develop分支时运行，并在对这些分支的拉取请求时运行使用 Node.js 16.x 和 18.x 测试代码库
确保包正确构建
验证所有测试通过
发布：当更改被推送到
main分支并且构建/测试作业成功时运行使用
release-please来管理版本升级和变更日志更新根据常规提交创建包含版本变更的发布 PR
合并发布 PR 时自动发布到 npm
发布流程
该项目遵循语义版本控制：
主要版本：重大变更（不向后兼容）
次要版本：新功能（向后兼容）
补丁版本：错误修复和小改进
提交应遵循常规提交格式：
feat: add new feature- 小版本升级fix: resolve bug- 补丁版本升级docs: update documentation- 无版本升级chore: update dependencies- 无版本升级BREAKING CHANGE: change API- 主要版本升级
当您推送到main时， release-please将分析提交并自动创建或更新具有适当版本提升和变更日志条目的发布 PR。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。
作者
Abou Koné - 工程主管兼首席技术官
如需更多信息或支持，请在 GitHub 存储库上打开一个问题。