MySQL Query MCP Server

MySQL Query MCP Server

site icon
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 工具进行数据库查询

工具列表

  1. query:执行只读 SQL 查询
  2. info:获取数据库的详细信息
  3. environments:列出所有配置的环境

常见问题解答

  • 连接问题:检查数据库凭证、确保 MySQL 服务器运行、检查防火墙规则
  • 错误:没有可用的连接池:确保已定义所有必需的环境变量
  • 错误:查询执行失败:验证 SQL 语法,确保仅使用支持的查询类型

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# 全局安装
npm install -g mysql-query-mcp-server

# 或直接运行
npx mysql-query-mcp-server

调试方式

启用调试日志:

DEBUG=true mysql-query-mcp-server

许可证

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