AnalyticDB for MySQL MCP 服务器

AnalyticDB for MySQL MCP 服务器作为 AI 代理与 AnalyticDB for MySQL 数据库之间的通用接口。它使 AI 代理与 AnalyticDB for MySQL 之间能够无缝通信，帮助 AI 代理检索 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 服务器，可以使用以下命令安装 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: 在 AnalyticDB for MySQL 集群中执行 SQL 查询

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

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

• 资源

  • 内置资源

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

  • 资源模板

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

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

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

• 提示

目前尚未提供。