AnalyticDB for MySQL MCP Server 分析型数据库 MySQL MCP 服务器作为一个通用接口，连接 AI Agent 和 AnalyticDB for MySQL，实现两者之间的无缝通信。它帮助 AI Agent 获取 AnalyticDB for MySQL 数据库的元数据并执行 SQL 操作。

1. MCP 客户端配置

模式 1：使用本地文件

• 下载 GitHub 仓库

git clone https://github.com/aliyun/alibabacloud-adb-mysql-mcp-server

• MCP 集成

在 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alibabacloud-adb-mysql-mcp-server",
        "run",
        "adb-mysql-mcp-server"
      ],
      "env": {
        "ADB_MYSQL_HOST": "host",
        "ADB_MYSQL_PORT": "port",
        "ADB_MYSQL_USER": "database_user",
        "ADB_MYSQL_PASSWORD": "database_password",
        "ADB_MYSQL_DATABASE": "database"
      }
    }
  }
}

模式 2：使用 PIP 模式

• 安装

使用以下包安装 MCP 服务器：

pip install adb-mysql-mcp-server

• MCP 集成

在 MCP 客户端配置文件中添加以下配置：

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "adb-mysql-mcp-server",
        "adb-mysql-mcp-server"
      ],
      "env": {
        "ADB_MYSQL_HOST": "host",
        "ADB_MYSQL_PORT": "port",
        "ADB_MYSQL_USER": "database_user",
        "ADB_MYSQL_PASSWORD": "database_password",
        "ADB_MYSQL_DATABASE": "database"
      }
    }
  }
}

2. 开发自己的 AnalyticDB for MySQL MCP 服务器

如果想开发自己的 AnalyticDB for MySQL MCP Server，可以使用以下步骤安装 Python 依赖项：

1. 从 GitHub 下载源代码。
2. 安装 uv 包管理器。
3. 安装 Node.js（提供名为 npx 的节点包工具）。
4. 在项目根目录中使用以下命令安装 Python 依赖项：

uv pip install -r pyproject.toml

5. 如果想在本地调试 MCP 服务器，可以启动一个 MCP Inspector，使用以下命令：

npx @modelcontextprotocol/inspector \
-e ADB_MYSQL_HOST=your_host \
-e ADB_MYSQL_PORT=your_port \
-e ADB_MYSQL_USER=your_username \
-e ADB_MYSQL_PASSWORD=your_password \
-e ADB_MYSQL_DATABASE=your_database \
uv --directory /path/to/alibabacloud-adb-mysql-mcp-server run adb-mysql-mcp-server

3. AnalyticDB for MySQL MCP 服务器组件介绍

工具

• execute_sql：执行 SQL 查询。
• get_query_plan：获取查询计划。
• get_execution_plan：获取实际执行计划及其统计信息。

资源

• 表：表示数据库中的表。
• 列：表示表中的列。
• 索引：表示表上的索引。