MCP MySQL App

MCP MySQL App

site icon
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 服务器的网络连接

使用教程

使用依赖

  1. 安装 Node.js
  2. 克隆仓库
git clone <repository-url>
cd mcp-mysql-app

安装教程

  1. 安装依赖
npm install
  1. 创建 .env 文件
MYSQL_HOST=your_mysql_host
MYSQL_USER=your_mysql_username
MYSQL_PASSWORD=your_mysql_password
MYSQL_DATABASE=your_database_name
MYSQL_PORT=3306
  1. 构建项目
npm run build

调试方式

  1. 配置 Cursor MCP 文件
  2. 配置 Claude 设置文件
  3. 在 AI 环境中测试 MySQL 工具

示例命令:

# 检查连接
"Check if the MySQL connection is working."

# 查询数据
"Show me the first 10 records from the users table."

许可证

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