返回 MCP 目录
public公开dns本地运行

azure-postgresql-mcp

Azure Database for PostgreSQL MCP Server是一个基于Model Context Protocol (MCP)标准的服务器,允许AI模型与Azure PostgreSQL数据库进行交互,提供标准化的数据访问能力。

article

README

🚀 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 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端