Azure AI Agent Service MCP 服务器

此MCP服务器与Azure AI Foundry集成，可以连接到您现有的Azure AI代理，利用Azure AI Foundry中可用的各种模型和知识工具，如Azure AI搜索和Bing Web Grounding。

功能

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

工具

• connect_agent

  • 通过ID连接到特定的Azure AI代理
  • 输入：
    • agent_id (字符串)：要连接的Azure AI代理的ID
    • query (字符串)：发送给代理的问题或请求
    • thread_id (字符串, 可选)：用于继续对话的线程ID
  • 返回：来自代理的格式化响应

• query_default_agent

  • 向默认配置的代理发送查询
  • 输入：
    • query (字符串)：发送给代理的问题或请求
    • thread_id (字符串, 可选)：用于继续对话的线程ID
  • 返回：来自默认代理的格式化响应

• list_agents

  • 列出项目中所有可用的Azure AI代理
  • 返回：包含其ID和名称的可用代理列表

配置

设置Azure

1. 通过Azure AI Foundry创建Azure AI代理
2. 记录您的Azure AI项目连接字符串
3. 记录您的代理ID（您需要这些来连接到特定的代理）
4. 使用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 目录中。在运行或开发时：

1. 始终从项目根目录激活虚拟环境
2. 运行 Python 命令时，请导航到 python 目录
3. 安装包时，请确保您位于包含 pyproject.toml 的 python 目录中

许可证

此项目根据 MIT 许可证获得许可。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参见项目仓库中的 LICENSE 文件。