🚀 MySQL 服务器 MCP 代理

这是一个基于 TypeScript 的 MCP 代理服务器，主要用于访问 MySQL 数据库。它能很好地演示核心的 MCP 概念，具体包括执行 SQL 查询的工具，以及通过环境变量连接 MySQL 数据库的方法。

🚀 快速开始

此 MCP 代理服务器可帮助您轻松访问 MySQL 数据库，通过简单配置即可开启使用。

✨ 主要特性

工具

• query：可执行 SQL 查询。该工具接收字符串类型的 SQL 查询作为参数，并返回查询结果。

📦 安装指南

开发环境依赖安装

安装项目所需依赖：

npm install

服务器构建

构建服务器：

npm run build

开发模式

开启带有自动重建功能的开发模式：

npm run watch

与 Claude 桌面集成安装

若要与 Claude 桌面一起使用，请添加服务器配置：

• 在 MacOS 上，配置文件路径为：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上，配置文件路径为：%APPDATA%/Claude/claude_desktop_config.json

配置文件内容如下：

{
  "mcpServers": {
    "mysql": {
      "command": "/path/to/mysql-server/build/index.js",
      "env": {
        "MYSQL_HOST": "your-mysql-host",
        "MYSQL_USER": "your-mysql-user",
        "MYSQL_PASSWORD": "your-mysql-password",
        "MYSQL_DATABASE": "your-mysql-database"
      }
    }
  }
}

调试说明

由于 MCP 代理通过标准输入输出进行通信，调试可能具有挑战性。我们推荐使用 MCP 检查器，它作为包脚本可用，使用以下命令启动：

npm run inspector

检查器将在您的浏览器中提供一个访问调试工具的 URL。

📚 详细文档

配置环境变量

在您的 MCP 代理服务器配置中，需要设置以下环境变量：