Foundry Apim MCP Server

AI Foundry APIM MCP服务器

用于Azure AI Foundry的MCP（模型上下文协议）服务器，将项目管理、模型部署、代理和聊天操作作为工具公开。支持本地开发（Azure CLI身份验证）和生产（OAuth令牌传递）。

快速开始

# Install
git clone 
cd foundry-apim-mcp-server
uv sync

# Login to Azure (default auth mode)
az login

# Start the server
uv run foundry-mcp-server

服务器启动于 http://localhost:8000/mcp （流式HTTP传输）。

来自您的MCP客户：

1. list_projects()                          # discover available projects
2. connect(account_name="...", project_name="...")  # connect to one
3. list_models()                            # see deployed models
4. create_agent(name="my-agent", ...)       # create an agent
5. chat(agent_name="my-agent", message="Hello!")    # chat with it

项目标签筛选器

重要提示： 默认情况下， list_projects 仅返回具有以下条件的项目 TechConnect Azure中的标签。 没有此标签的项目将被自动跳过。 要更改或禁用此筛选器，请编辑 PROJECT_TAG_FILTER 在 foundry_apim_mcp_server/foundry_client.py: ``python PROJECT_TAG_FILTER = "TechConnect" # set to None to disable filtering ``

工具

提示

指导LLM完成多步骤任务的预配置工作流：

认证

受控于 AUTH_MODE 环境变量：

本地开发 --只需登录一次，不需要其他配置：

az login
uv run foundry-mcp-server

生产/远程 --MCP客户端必须发送Azure Entra ID承载令牌：

AUTH_MODE=passthrough uv run foundry-mcp-server

环境变量

所有变量都是可选的。复制 .env.example 到 .env 开始：

cp .env.example .env

先决条件

• Python 3.11+
• 紫外线 （推荐）或pip
• Azure命令行界面(az login)用于默认身份验证模式
• Azure AI Foundry项目

MCP客户端配置

VS代码/克劳德桌面

{
  "mcpServers": {
    "ai-foundry": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

使用时 AUTH_MODE=passthrough，添加授权标头：

{
  "mcpServers": {
    "ai-foundry": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

AI铸造代理（作为MCP工具）

from azure.ai.projects.models import MCPTool

mcp_tool = MCPTool(
    server_label="ai-foundry-mcp",
    server_url="http://localhost:8000/mcp",
    require_approval="never",
)

码头工人

# Build
docker build -t foundry-mcp-server .

# Run with managed identity (e.g. on Azure Container Apps / ACI)
docker run -p 8000:8000 foundry-mcp-server

# Run with token passthrough
docker run -p 8000:8000 -e AUTH_MODE=passthrough foundry-mcp-server

# Run with an .env file
docker run -p 8000:8000 --env-file .env foundry-mcp-server

图像默认为 MCP_HOST=0.0.0.0 因此，它监听容器内的所有接口。

认证流程

此服务器确实 不 使用OBO（代表）流。

它支持两种模式，由 AUTH_MODE 环境变量：

所需的Azure RBAC权限

标识（托管标识或用户主体）必须具有：

如果你只 connect 到已知的项目端点（跳过 list_projects)，the 读者 订阅中的角色不是必需的。

Specific ARM actions required by list_projects

如果使用自定义角色而不是内置角色 读者，授权这些操作：

环境变量引用

发展

uv sync

# Run with auto-reload (FastMCP dev mode)
uv run fastmcp dev foundry_apim_mcp_server/server.py

# Or run directly
uv run python -m foundry_apim_mcp_server.server