
MCP MySQL App

2025.03.23
0
TypeScriptMySQL 交互数据库工具数据库
mcp-mysql-app 是一个基于 Model Context Protocol (MCP) 的工具服务器实现,专门用于通过 AI 接口与 MySQL 数据库进行交互。该项目提供了一套工具,使 AI 系统能够连接到 MySQL 数据库并执行查询操作,支持 SQL 查询和数据库连接性检查。
View on GitHub
Overview
基本能力
产品定位
mcp-mysql-app 是一个专门用于通过 AI 接口与 MySQL 数据库交互的工具服务器,旨在简化 AI 系统与数据库的交互过程。
核心功能
- 提供简单的 MySQL 工具集成
- 类型安全的工具定义
- 增强的错误处理
- 支持处理请求中止信号
- 会话感知
适用场景
- AI 系统需要与 MySQL 数据库交互的场景
- 需要自动化执行 SQL 查询的场景
- 数据库连接性检查
工具列表
sql_check_connection
: 检查 MySQL 连接是否正常sql_query
: 在连接的数据库上执行 SQL 查询
常见问题解答
- 确保 MySQL 连接详情正确
- 确保 Node.js 已正确安装
- 检查 AI 平台中的 MCP 配置
- 查看日志文件中的错误信息
- 验证与 MySQL 服务器的网络连接
使用教程
使用依赖
- 安装 Node.js
- 克隆仓库
git clone <repository-url>
cd mcp-mysql-app
安装教程
- 安装依赖
npm install
- 创建
.env
文件
MYSQL_HOST=your_mysql_host
MYSQL_USER=your_mysql_username
MYSQL_PASSWORD=your_mysql_password
MYSQL_DATABASE=your_database_name
MYSQL_PORT=3306
- 构建项目
npm run build
调试方式
- 配置 Cursor MCP 文件
- 配置 Claude 设置文件
- 在 AI 环境中测试 MySQL 工具
示例命令:
# 检查连接
"Check if the MySQL connection is working."
# 查询数据
"Show me the first 10 records from the users table."