Adb MySQL MCP Server

MySQL MCP服务器分析数据库

英语| 中文

MySQL MCP服务器的AnalyticDB是AI代理和 MySQL分析数据库它提供两类能力：

• OpenAPI工具 (openapi 组）：通过阿里云OpenAPI管理集群、白名单、帐户、网络、监控、诊断和审计日志。
• SQL工具和资源 (sql 组）：直接连接到ADB MySQL集群以执行SQL、查看执行计划和浏览数据库元数据。

只读工具带有注释 ToolAnnotations(readOnlyHint=True) 根据MCP协议，允许客户端将它们与变异操作区分开来。

一、Prerequisites

• Python>=3.13
• 紫外线 （推荐包管理器和运行器）
• 阿里云AccessKey（OpenAPI工具需要）
• 可选：ADB MySQL连接凭据（用于直接连接模式下的SQL工具）

二、Quick Start

2.1使用 樱桃工作室 （推荐）

1. 下载并安装 樱桃工作室
2. 跟随 文档 安装 uv，这是MCP环境所必需的
3. 根据配置和使用ADB MySQL MCP 文档。您可以使用下面的JSON快速导入配置。

cherry-studio configuration

配置A——仅限SQL工具（执行查询、查看计划、浏览元数据）：

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "name": "adb-mysql-mcp-server",
      "type": "stdio",
      "isActive": true,
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alibabacloud-adb-mysql-mcp-server",
        "run",
        "adb-mysql-mcp-server"
      ],
      "env": {
        "ADB_MYSQL_HOST": "your_adb_mysql_host",
        "ADB_MYSQL_PORT": "3306",
        "ADB_MYSQL_USER": "your_username",
        "ADB_MYSQL_PASSWORD": "your_password",
        "ADB_MYSQL_DATABASE": "your_database"
      }
    }
  }
}

配置B——OpenAPI工具（集群管理、诊断、监控）：

备注：请设置 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET 您的阿里云AccessKey凭据。

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "name": "adb-mysql-mcp-server",
      "type": "stdio",
      "isActive": true,
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alibabacloud-adb-mysql-mcp-server",
        "run",
        "adb-mysql-mcp-server"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_access_key_secret"
      }
    }
  }
}

您可以通过将所有环境变量设置在一起来组合这两种配置。当AK/SK未配置时，OpenAPI工具会自动禁用，只有SQL工具保持活动状态。

2.2使用克劳德代码

从GitHub下载并同步依赖关系：

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

将以下配置添加到Claude Code MCP配置文件（项目级别： .mcp.json 在项目根或用户级别： ~/.claude/settings.json):

stdio传输：

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/alibabacloud-adb-mysql-mcp-server",
        "run",
        "adb-mysql-mcp-server"
      ],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_access_key_secret",
        "ALIBABA_CLOUD_SECURITY_TOKEN": "",
        // Uncomment the following lines to enable SQL tools for direct database connection:
        // "ADB_MYSQL_HOST": "your_adb_mysql_host",
        // "ADB_MYSQL_PORT": "3306",
        // "ADB_MYSQL_USER": "your_username",
        // "ADB_MYSQL_PASSWORD": "your_password",
        // "ADB_MYSQL_DATABASE": "your_database"
      }
    }
  }
}

SSE运输 --首先启动服务器，然后配置客户端：

export ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
# Uncomment the following lines to enable SQL tools for direct database connection:
# export ADB_MYSQL_HOST="your_adb_mysql_host"
# export ADB_MYSQL_PORT="3306"
# export ADB_MYSQL_USER="your_username"
# export ADB_MYSQL_PASSWORD="your_password"
# export ADB_MYSQL_DATABASE="your_database"
export SERVER_TRANSPORT=sse
export SERVER_PORT=8000

uv --directory /path/to/alibabacloud-adb-mysql-mcp-server run adb-mysql-mcp-server

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}

可流式HTTP传输 --首先启动服务器，然后配置客户端：

export ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
# Uncomment the following lines to enable SQL tools for direct database connection:
# export ADB_MYSQL_HOST="your_adb_mysql_host"
# export ADB_MYSQL_PORT="3306"
# export ADB_MYSQL_USER="your_username"
# export ADB_MYSQL_PASSWORD="your_password"
# export ADB_MYSQL_DATABASE="your_database"
export SERVER_TRANSPORT=streamable_http
export SERVER_PORT=8000

uv --directory /path/to/alibabacloud-adb-mysql-mcp-server run adb-mysql-mcp-server

{
  "mcpServers": {
    "adb-mysql-mcp-server": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

备注：何时 ADB_MYSQL_USER 和 ADB_MYSQL_PASSWORD 未配置，但AK/SK可用，通过OpenAPI自动创建一个临时数据库帐户用于SQL执行，并在之后进行清理。

2.3使用Cline

设置环境变量并运行MCP服务器：

export ALIBABA_CLOUD_ACCESS_KEY_ID="your_access_key_id"
export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your_access_key_secret"
export SERVER_TRANSPORT=sse
export SERVER_PORT=8000

uv --directory /path/to/alibabacloud-adb-mysql-mcp-server run adb-mysql-mcp-server

然后配置Cline远程服务器：

remote_server = "http://127.0.0.1:8000/sse"

三、环境变量

四、刀具清单

4.1集群管理（组： openapi)

4.2诊断和监测（组： openapi)

4.3管理和审计（组： openapi)

4.4高级诊断（组： openapi)

4.5 SQL工具（组： sql)

4.6 MCP资源（组： sql)

五、本地开发

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

运行测试：

uv run python -m pytest test/ -v

使用MCP检查器进行调试：

npx @modelcontextprotocol/inspector \
  -e ALIBABA_CLOUD_ACCESS_KEY_ID=your_ak \
  -e ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_sk \
  uv --directory /path/to/alibabacloud-adb-mysql-mcp-server run adb-mysql-mcp-server

六、SKILL

除了上面的MCP服务器，这个项目还提供了一个 独立 技能下 skill/ 目录。该技能可以直接部署到Claude Code，而无需依赖此MCP服务器（它通过以下方式调用ADB MySQL OpenAPI call_adb_api.py 在SKILL目录中）。

该技能涵盖了集群信息查询、性能监控、慢速查询诊断、SQL模式分析和SQL执行，并为常见场景提供了内置的指导性诊断工作流。

有关设置和使用的详细信息，请参阅 skill/skill_readme.md.

备注：此技能的演变将与我们未来的下一代代理保持一致。敬请期待。

许可证

Apache许可证2.0