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認証（推奨）を含む複数の認証方式をサポートしています。

💻 使用例

基本的な使用法

上記の「クイックスタート」で説明した手順に従って、Azure Database for PostgreSQL MCP Serverをインストールし、MCPクライアントを設定します。

高度な使用法

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の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。