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