Azure Database for PostgreSQL MCP Server（预览版）

介绍

Azure Database for PostgreSQL MCP Server 是基于 Model Context Protocol (MCP) 的服务器，旨在为用户提供与 Azure Database for PostgreSQL 相连的能力。该服务目前处于预览阶段，功能正在不断开发和完善中。

功能概述

• 连接协议：支持通过 Model Context Protocol 连接到 Azure Database for PostgreSQL。
• 工具集：提供了一系列工具和接口，方便用户管理和操作数据库。
• 身份验证：支持多种身份验证方式，包括 Microsoft Entra 身份验证（推荐）。

快速入门

决条件

1. 安装 Python 环境。
2. 下载并安装 Azure Database for PostgreSQL MCP Server。

安装步骤

# 创建虚拟环境
python -m venv azure_postgres_mcp

# 激活虚拟环境
source azure_postgres_mcp/bin/activate

# 安装依赖项
pip install -r requirements.txt

配置 MCP 客户端（Claude Desktop）

1. 打开 claude_desktop_config.json 文件。
2. 添加以下配置：

   {
       "mcp": {
           "servers": {
               "azure-postgresql-mcp": {
                   "command": "<path to the virtual environment>/Scripts/python",
                   "args": [
                       "<路径到 azure_postgresql_mcp.py 文件>"
                   ],
                   "env": {
                       "PGHOST": "<Azure Database for PostgreSQL 实例的完全限定域名>",
                       "PGUSER": "<用户名>",
                       "PGPASSWORD": "<密码>",
                       "PGDATABASE": "<数据库名称>"
                   }
               }
           }
       }
   }
   

配置 MCP 客户端（Visual Studio Code）

1. 打开 Visual Studio Code 的设置。
2. 在搜索栏中输入 MCP 并选择编辑 settings.json 文件。
3. 添加以下配置：

   {
       "mcp": {
           "servers": {
               "azure-postgresql-mcp": {
                   "command": "<路径到虚拟环境>/Scripts/python",
                   "args": [
                       "<路径到 azure_postgresql_mcp.py 文件>"
                   ],
                   "env": {
                       "PGHOST": "<Azure Database for PostgreSQL 实例的完全限定域名>",
                       "PGUSER": "<用户名>",
                       "PGPASSWORD": "<密码>",
                       "PGDATABASE": "<数据库名称>"
                   }
               }
           }
       }
   }
   

使用 Microsoft Entra 身份验证方法

为了通过 Microsoft Entra 身份验证连接到 Azure Database for PostgreSQL MCP Server，请更新 claude_desktop_config.json 文件（Claude Desktop）和 settings.json 文件（Visual Studio Code）中的配置：

{
    "azure-postgresql-mcp": {
        "command": "<路径到虚拟环境>/Scripts/python",
        "args": [
            "<路径到 azure_postgresql_mcp.py 文件>"
        ],
        "env": {
            "PGHOST": "<Azure Database for PostgreSQL 实例的完全限定域名>",
            "PGUSER": "<Microsoft Entra ID 用户名或 Azure 资源的系统分配标识符名称>",
            "AZURE_USE_AAD": "True",
            "AZURE_SUBSCRIPTION_ID": "<您的 Azure 订阅 ID>",
            "AZURE_RESOURCE_GROUP": "<包含 Azure Database for PostgreSQL 实例的资源组>"
        }
    }
}

贡献指南

Azure Database for PostgreSQL MCP Server 目前处于预览阶段。如果您有任何问题或建议，请参考 CONTRIBUTING.md 文件。

许可证

该项目 licensed under the MIT License。详细信息请查看 LICENSE 文件。