alibabacloud-adb-mysql-mcp-server

🚀 AnalyticDB for MySQL 多计算引擎（MCP）服务器

AnalyticDB for MySQL MCP 服务器可作为 AI 代理与 AnalyticDB for MySQL 数据库之间的通用接口。它实现了 AI 代理与 AnalyticDB for MySQL 的无缝通信，助力 AI 代理获取数据库元数据并执行 SQL 操作。

🚀 快速开始

✨ 主要特性

• 作为 AI 代理与 AnalyticDB for MySQL 数据库的通用接口，实现无缝通信。
• 帮助 AI 代理获取数据库元数据并执行 SQL 操作。

📦 安装指南

模式 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"
      }
    }
  }
}

💻 使用示例

开发自己的 AnalyticDB for MySQL MCP Server

如果您想开发自己的 AnalyticDB for MySQL MCP Server，可以按以下步骤操作：

1. 从 GitHub 下载源代码。
2. 安装 uv 包管理器。
3. 安装 Node.js（提供名为 npx 的节点包工具）。
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

📚 详细文档

AnalyticDB for MySQL MCP Server 组件介绍

• 工具
  • execute_sql：执行 SQL 查询。
  • get_table_schema：获取表结构信息。
  • list_tables：列出所有表。
• 资源
  • 内置资源：数据库元数据（例如表、列等）。
  • 外部资源：支持通过插件扩展其他数据源。

通过以上配置和工具，您可以轻松使用 AnalyticDB for MySQL MCP Server 进行数据分析和处理。