Azure AI エージェントサービス MCP サーバー

この MCP サーバーは Azure AI Foundry と統合され、Azure AI Search や Bing Web Grounding など、Azure AI Foundry 内で利用可能な幅広いモデルと知識ツールを活用して、既存の Azure AI エージェントへの接続を可能にします。

特徴

🤖エージェント統合- 既存の Azure AI エージェントに接続
🔄シームレスなワークフロー- あらゆるMCPクライアント内でエージェントを直接使用できます
🛡️安全- すべての接続で Azure 資格情報が使用されます
🧠会話メモリ- 各クライアントセッションは独立した会話履歴を保持します

ツール

接続エージェント
- ID で特定の Azure AI エージェントに接続する
- 入力:
  - agent_id (文字列): 接続するAzure AIエージェントのID
  - query （文字列）：エージェントに送信する質問またはリクエスト
  - thread_id （文字列、オプション）：会話の継続のためのスレッドID
- 戻り値: エージェントからのフォーマットされた応答
クエリデフォルトエージェント
- デフォルトで設定されたエージェントにクエリを送信する
- 入力:
  - query （文字列）：エージェントに送信する質問またはリクエスト
  - thread_id （文字列、オプション）：会話の継続のためのスレッドID
- 戻り値: デフォルトエージェントからのフォーマットされた応答
エージェント一覧
- プロジェクトで利用可能なすべての Azure AI エージェントを一覧表示する
- 戻り値: 利用可能なエージェントのIDと名前のリスト

構成

Azureのセットアップ

Azure AI Foundry を通じて Azure AI エージェントを作成する
Azure AIプロジェクトの接続文字列をメモします
エージェントの ID をメモします (特定のエージェントに接続する際に必要になります)
Azure 資格情報を使用して認証する: az login

環境変数

このサーバーには次の環境変数が必要です。

# Required
PROJECT_CONNECTION_STRING=your-project-connection-string

# Optional (configure default agent)
DEFAULT_AGENT_ID=your-default-agent-id

インストール

前提条件

Python 3.10以上
Azure CLI (az)がインストールおよび構成されている
必要な機能を備えた既存の Azure AI エージェント

設定

# Setup environment
python -m venv .venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
pip install mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server directly (from ./src/python)
python -m azure_agent_mcp_server

uv を使用する場合:

# Setup environment with uv
uv venv
.venv\Scripts\activate  # On Windows
source .venv/bin/activate  # On macOS/Linux

# Install dependencies
uv add mcp[cli] azure-identity python-dotenv azure-ai-projects aiohttp

# Run server (F)
uv run -m azure_agent_mcp_server

Claude Desktopでの使用

Claude Desktop で使用するには、構成ファイルに以下を追加します。

{
  "mcpServers": {
    "azure-agent": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "run",
        "-m",
        "azure_agent_mcp_server"
      ],
      "env": {
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

uvを使用したくない場合は、python を使用できます。

{
  "mcpServers": {
    "azure-agent": {
      "command": "python",
      "args": [
        "-m",
        "azure_agent_mcp_server"
      ],
      "cwd": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
      "env": {
        "PYTHONPATH": "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "PROJECT_CONNECTION_STRING": "your-project-connection-string",
        "DEFAULT_AGENT_ID": "your-default-agent-id"
      }
    }
  }
}

他のMCPクライアントとの使用

このサーバーはMCPプロトコル仕様に準拠しており、MCP互換のクライアントで使用できます。外部MCPサーバーへの接続方法に関する具体的な手順については、クライアントのドキュメントを参照してください。

開発ノート

このプロジェクトはポリグロット構造を採用しており、Pythonコードはpythonディレクトリに配置されています。実行時または開発時には以下の点にご注意ください。

常にプロジェクトルートから仮想環境をアクティブ化します
Pythonコマンドを実行するときにpythonディレクトリに移動する
パッケージをインストールするには、pyproject.toml がある python ディレクトリにいることを確認してください。

ライセンス

このプロジェクトはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

任意の MCP クライアント内で Azure AI エージェントへの接続を可能にし、ユーザーは会話型インターフェイスを通じて Azure AI Foundry のモデルと、Azure AI Search や Bing Web Grounding などのナレッジツールを活用できるようになります。

Azure AI Agent Service MCP Server

Azure AI エージェントサービス MCP サーバー

特徴

ツール

構成

Azureのセットアップ

環境変数

インストール

前提条件

設定

Claude Desktopでの使用

他のMCPクライアントとの使用

開発ノート

ライセンス

Appeared in Searches

Azure AI エージェント サービス MCP サーバー

特徴

ツール

構成

Azureのセットアップ

環境変数

インストール

前提条件

設定

Claude Desktopでの使用

他のMCPクライアントとの使用

開発ノート

ライセンス

Appeared in Searches

Azure AI エージェントサービス MCP サーバー