Alibabacloud Adbpg MCP Server

🚀 AnalyticDB PostgreSQL MCP サーバー

AnalyticDB PostgreSQL MCP サーバーは、AI Agent と AnalyticDB PostgreSQL データベース間の汎用インターフェースとして機能し、両者間のシームレスな通信を実現します。これにより、AI Agent はデータベースのメタデータを取得し、SQL 操作を実行することができます。

🚀 クイックスタート

📦 インストール

ダウンロード

Github からダウンロードします。

git clone git@github.com:aliyun/alibabacloud-adbpg-mcp-server.git

MCP 統合

MCP クライアントの設定ファイルに以下の設定を追加します。

"mcpServers": {
  "adbpg-mcp-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/adbpg-mcp-server",
      "run",
      "adbpg-mcp-server"
    ],
    "env": {
      "ADBPG_HOST": "host",
      "ADBPG_PORT": "port",
      "ADBPG_USER": "username",
      "ADBPG_PASSWORD": "password",
      "ADBPG_DATABASE": "database"
    }
  }
}

💻 使用例

基本的な使用法

# 仮想環境の作成とアクティブ化
uv venv .venv
source .venv/bin/activate  # Linux/Mac
# または
.venv\Scripts\activate     # Windows

# 依存関係のインストール
uv pip install -e .

# サーバーの起動
uv run adbpg-mcp-server

✨ 主な機能

ツール

• execute_select_sql：AnalyticDB PostgreSQL サーバー上で SELECT SQL クエリを実行します。
• execute_dml_sql：AnalyticDB PostgreSQL サーバー上で DML（INSERT、UPDATE、DELETE）SQL クエリを実行します。
• execute_ddl_sql：AnalyticDB PostgreSQL サーバー上で DDL（CREATE、ALTER、DROP）SQL クエリを実行します。
• analyze_table：テーブルの統計情報を収集します。
• explain_query：クエリの実行計画を取得します。

リソース

組み込みリソース

• adbpg:///schemas：データベース内のすべてのスキーマを取得します。

リソーステンプレート

• adbpg:///{schema}/tables：特定のスキーマ内のすべてのテーブルを一覧表示します。
• adbpg:///{schema}/{table}/ddl：テーブルの DDL を取得します。
• adbpg:///{schema}/{table}/statistics：テーブルの統計情報を表示します。

🔧 技術詳細

環境変数

MCP サーバーは、AnalyticDB PostgreSQL インスタンスに接続するために以下の環境変数が必要です。

• ADBPG_HOST：データベースのホストアドレス
• ADBPG_PORT：データベースのポート
• ADBPG_USER：データベースのユーザー名
• ADBPG_PASSWORD：データベースのパスワード
• ADBPG_DATABASE：データベースの名前

依存関係

• Python 3.10 以上
• 必要なパッケージ：
  • mcp >= 1.4.0
  • psycopg >= 3.1.0
  • python-dotenv >= 1.0.0
  • pydantic >= 2.0.0