Azure AI 代理服务 MCP 服务器

此 MCP 服务器与 Azure AI Foundry 集成，以利用 Azure AI Foundry 中提供的各种模型和知识工具（例如 Azure AI Search 和 Bing Web Grounding）实现与您现有 Azure AI 代理的连接。

特征

🤖代理集成- 连接到您现有的 Azure AI 代理
🔄无缝工作流程- 在任何 MCP 客户端中直接使用您的代理
🛡️安全- 所有连接均使用您的 Azure 凭据
🧠对话记忆- 每个客户端会话都维护独立的对话历史记录

工具

连接代理
- 通过 ID 连接到特定的 Azure AI 代理
- 输入：
  - agent_id (string)：要连接的 Azure AI 代理的 ID
  - query （字符串）：发送给代理的问题或请求
  - thread_id （字符串，可选）：用于继续对话的线程 ID
- 返回：来自代理的格式化响应
查询默认代理
- 向默认配置的代理发送查询
- 输入：
  - query （字符串）：发送给代理的问题或请求
  - thread_id （字符串，可选）：用于继续对话的线程 ID
- 返回：来自默认代理的格式化响应
列表代理
- 列出项目中所有可用的 Azure AI 代理
- 返回：可用代理的列表及其 ID 和名称

配置

设置 Azure

通过 Azure AI Foundry 创建 Azure AI 代理
记下 Azure AI 项目连接字符串
记下您的代理的 ID（您需要这些 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