
MySQL Query MCP Server

2025.04.14
0
TypeScript数据库查询AI 助手集成数据库
MySQL Query MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专门为 AI 助手提供对 MySQL 数据库的只读查询功能。它允许用户执行查询、探索数据库结构并直接从 AI 工具中调查数据。该服务支持多种预定义环境(如本地、开发、测试和生产环境),并提供了数据库信息和元数据查询功能。
View on GitHub
Overview
基本能力
产品定位
MySQL Query MCP Server 是一个专为 AI 助手设计的 MySQL 数据库只读查询服务,旨在通过 MCP 协议提供数据调查和探索功能。
核心功能
- 执行只读 MySQL 查询(仅支持 SELECT、SHOW、DESCRIBE)
- 支持预定义环境(本地、开发、测试、生产)
- 提供数据库信息和元数据
- 列出可用的数据库环境
- 支持 SSL 连接以确保安全访问
- 实现查询超时以防止长时间运行的操作
适用场景
- 数据调查和探索
- 数据库结构分析
- 通过 AI 工具进行数据库查询
工具列表
- query:执行只读 SQL 查询
- info:获取数据库的详细信息
- environments:列出所有配置的环境
常见问题解答
- 连接问题:检查数据库凭证、确保 MySQL 服务器运行、检查防火墙规则
- 错误:没有可用的连接池:确保已定义所有必需的环境变量
- 错误:查询执行失败:验证 SQL 语法,确保仅使用支持的查询类型
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
# 全局安装
npm install -g mysql-query-mcp-server
# 或直接运行
npx mysql-query-mcp-server
调试方式
启用调试日志:
DEBUG=true mysql-query-mcp-server