AnalyticDB PostgreSQL MCP Server
2025.04.21
2
Python数据库接口AI代理通信数据库
AnalyticDB PostgreSQL MCP Server 是一个通用的接口服务，用于连接AI代理与AnalyticDB PostgreSQL数据库。它使得AI代理能够无缝地与AnalyticDB PostgreSQL进行通信，帮助AI代理获取数据库元数据并执行SQL操作。
View on GitHub
Overview
基本能力
产品定位
AnalyticDB PostgreSQL MCP Server 是一个通用的接口服务，用于连接AI代理与AnalyticDB PostgreSQL数据库。
核心功能
- 提供AI代理与AnalyticDB PostgreSQL数据库之间的无缝通信。
- 帮助AI代理获取数据库元数据。
- 执行SQL操作，包括SELECT、DML（INSERT, UPDATE, DELETE）和DDL（CREATE, ALTER, DROP）查询。
- 收集表统计信息。
- 获取查询执行计划。
适用场景
- AI代理需要与AnalyticDB PostgreSQL数据库进行交互的场景。
- 需要获取数据库元数据或执行SQL操作的自动化任务。
工具列表
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: 获取查询执行计划。
常见问题解答
- 需要配置环境变量以连接AnalyticDB PostgreSQL实例。
- 依赖Python 3.10或更高版本。
使用教程
使用依赖
- Python 3.10或更高版本。
- 依赖包：
- mcp >= 1.4.0
- psycopg >= 3.1.0
- python-dotenv >= 1.0.0
- pydantic >= 2.0.0
安装教程
- 下载项目：
git clone [email protected]:aliyun/alibabacloud-adbpg-mcp-server.git
- 创建并激活虚拟环境：
uv venv .venv
source .venv/bin/activate # Linux/Mac
# or
.venv\Scripts\activate # Windows
- 安装依赖：
uv pip install -e .
- 运行服务器：
uv run adbpg-mcp-server
调试方式
- 确保环境变量已正确配置：
ADBPG_HOST: 数据库主机地址ADBPG_PORT: 数据库端口ADBPG_USER: 数据库用户名ADBPG_PASSWORD: 数据库密码ADBPG_DATABASE: 数据库名称- 运行服务器后，检查日志以确认服务是否正常启动。