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 實例：

依賴項

• Python 3.10 或更高版本。
• 必要的包：
  • mcp >= 1.4.0
  • psycopg >= 3.1.0
  • python-dotenv >= 1.0.0
  • pydantic >= 2.0.0