Aliyun Alibabacloud Adb Mysql MCP Server

🚀 AnalyticDB for MySQL MCP Server

AnalyticDB for MySQL MCP サーバーは、AI Agent と AnalyticDB for MySQL を接続する汎用インターフェースで、両者間のシームレスな通信を実現します。AI Agent が AnalyticDB for MySQL データベースのメタデータを取得し、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 サーバーをインストールします。

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 サーバーの開発

独自の 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

📚 サーバーコンポーネントの説明

ツール

• execute_sql：SQL クエリを実行します。
• get_query_plan：クエリプランを取得します。
• get_execution_plan：実際の実行プランとその統計情報を取得します。

リソース

• 表：データベース内のテーブルを表します。
• 列：テーブル内の列を表します。
• 索引：テーブル上のインデックスを表します。