Azure Postgresql MCP

🚀 Azure Database for PostgreSQL MCP Server（预览版）

Azure Database for PostgreSQL MCP Server 基于 Model Context Protocol (MCP)，能让用户与 Azure Database for PostgreSQL 相连。此服务正处预览阶段，功能持续开发完善中。

🚀 快速开始

先决条件

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": "<数据库名称>"
                }
            }
        }
    }
}

✨ 主要特性

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

📚 详细文档

使用 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 文件。

📄 许可证

该项目根据 MIT 许可证授权。详细信息请查看 LICENSE 文件。