AnalyticDB for MySQL MCP Server

AnalyticDB for MySQL MCP Server 充当 AI Agent 和 AnalyticDB for MySQL 数据库之间的通用接口。它实现了 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 Server：

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 server

如果您想开发自己的 AnalyticDB for MySQL MCP Server，您可以使用以下命令安装 python 依赖包：

1. 从 GitHub 下载 源代码。
2. 安装 uv 包管理器。
3. 安装 Node.js，它提供了一个名为 npx 的 node 包工具
4. 使用以下命令在项目的根目录中安装 python 依赖项：

uv pip install -r pyproject.toml 

5. 如果您想在本地调试 mcp server，您可以使用以下命令启动一个 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 Server 组件介绍

• 工具

  • execute_sql: 在 AnalyticDB for MySQL 集群中执行 SQL 查询

  • get_query_plan: 获取 SQL 查询的查询计划

  • get_execution_plan: 获取带有运行时统计信息的 SQL 查询的实际执行计划

• 资源

  • 内置资源

    • adbmysql:///databases: 获取 analytic for mysql 集群中的所有数据库

  • 资源模板

    • adbmysql:///{schema}/tables: 获取特定数据库中的所有表

    • adbmysql:///{database}/{table}/ddl: 获取特定数据库中表的 DDL 脚本

    • adbmysql:///{config}/{key}/value: 获取集群中配置键的值

• 提示

目前未提供。