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 代理的 IDquery （字符串）：发送给代理的问题或请求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 文件。