Foundry Agents MCP Server

Foundry代理MCP服务器

一 MCP（模型上下文协议） 服务器 公开Azure AI Foundry代理、工作流和AI搜索向量数据库 作为MCP工具的功能。

支持两种传输方式：

• 标准 –供本地使用 uvx 或VS代码副本
• 超文本传输协议 –用于部署到 Azure容器应用 通过 azd up

存储库布局

src/
  foundry_agents_mcp/     ← MCP server (10 tools across 4 namespaces)
  foundry_agents/         ← Standalone agent & workflow implementations
    definitions/          ← Declarative YAML agent & workflow definitions
    case_study_agent.py   ← deploy-case-study-agent CLI command
    architecture_agent.py ← deploy-architecture-agent CLI command
    project_log_workflow.py ← run-project-log-workflow CLI command
infra/
  main.bicep              ← Container Apps + managed identity + role assignments
  app/server.bicep        ← Container App definition with health probes
  core/security/role.bicep
azure.yaml                ← azd service definition
Dockerfile                ← Multi-stage Alpine build
entrypoint.sh             ← Selects stdio or HTTP transport at startup
.env.sample               ← Template for local environment configuration

MCP工具命名空间

______________________________________________________________________

先决条件

• Python 3.10+
• 紫外线 安装
• 一 Azure AI Foundry 项目（用于代理工具）
• 一 Azure人工智能搜索 具有矢量层的资源（用于搜索/索引工具）
• 一 Azure OpenAI 部署了文本嵌入模型的资源

______________________________________________________________________

快速开始使用uvx

# Install and run directly from GitHub (no PyPI package required)
uvx --from git+https://github.com/denniszielke/foundry-agents-mcp-server@main foundry-agents-mcp-server

或者使用显式环境文件：

uvx --from git+https://github.com/denniszielke/foundry-agents-mcp-server@main --env-file .env foundry-agents-mcp-server

______________________________________________________________________

配置

所有配置都由环境变量驱动。复制 .env.sample 到 .env 并填写你的价值观。

备注 –通过部署时 azd up，所有这些值都将写入 .env 自动通过 infra/write_env.sh.用于当地开发运行 az login 和 使用 DefaultAzureCredential；不需要API密钥。

______________________________________________________________________

Claude桌面配置

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "foundry-agents": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/denniszielke/foundry-agents-mcp-server@main", "foundry-agents-mcp-server"],
      "env": {
        "AZURE_AI_PROJECT_ENDPOINT": "https://...",
        "AZURE_AI_SEARCH_ENDPOINT": "https://...",
        "AZURE_OPENAI_ENDPOINT": "https://..."
      }
    }
  }
}

______________________________________________________________________

工具参考和示例提示

代理命名空间

agents_list_agents

列出Foundry项目中可用的所有代理和工作流，包括其 ID、模型、描述和工具功能。

示例提示

• *“项目中有哪些代理？”*
• *“列出我可以调用的所有AI工作流”*
• *“向我展示这个Foundry项目中的代理及其能力”*

______________________________________________________________________

agents_invoke_agent

异步调用代理或工作流。返回一个 调用ID 到 跟踪进度。

示例提示

• *“问代理人 `` 总结最新的Azure AI公告”*
• *“用任务调用研究工作流程：分析人工智能服务的竞争格局”*
• *“将此文档发送给分析代理，并将文件文本作为上下文包含在内： ``"*

______________________________________________________________________

agents_get_invocation_status

检查代理调用是否仍在运行或已完成。

可能的状态: queued, in_progress, requires_action, cancelling, cancelled, failed, completed, expired

示例提示

• *“检查调用状态 ``"*
• *“我的代理任务完成了吗？ID: ``"*
• *“工作流是否仍在运行以供调用 ``?"*

______________________________________________________________________

agents_get_invocation_result

从已完成的调用中检索文本（和文件引用）输出。

示例提示

• *“从调用中获取结果 ``"*
• *“代理人拿什么身份证回来了 ``?"*
• *“显示已完成工作流的输出： ``"*

______________________________________________________________________

搜索命名空间

search_vector_db

对项目日志索引执行语义（向量）搜索。

示例提示

• *“查找与Azure Kubernetes服务相关的项目日志”*
• *“搜索关于机器学习的研讨会摘要”*
• *“哪些会议讨论了安全架构？”*
• *“查找有关微服务的博客文章，返回前10名结果”*

______________________________________________________________________

search_add_to_vector_db

将文档添加到项目日志向量索引中。内容自动 嵌入并存储在元数据旁边。

示例提示

• *“将此会议摘要添加到矢量数据库：title='Azure Workshop'，content='…'”*
• *“存储有关我们Kubernetes迁移讨论的新项目日志条目”*
• *“用标签索引这篇博客文章：azure、容器、devops”*

______________________________________________________________________

索引命名空间

index_create_project_log_index

使用正确的架构和HNSW创建项目日志Azure AI搜索索引 矢量配置。索引已存在时可以安全调用。

架构字段

示例提示

• *“设置项目日志搜索索引”*
• *“创建Azure AI搜索索引以存储项目摘要”*
• *“初始化项目日志的矢量数据库架构”*

______________________________________________________________________

index_ingest_project_log

将单个项目日志条目引入索引。索引已创建 如果它不存在，则自动执行。

示例提示

• *“添加研讨会日志：title='Azure AI Day'，entry_type='workshop'，customer_name='Contoso'，context='…'”*
• *“索引有关云迁移项目的新会议摘要”*
• *使用标签存储此仓库文档：python、mcp、azure*

______________________________________________________________________

示例代理和工作流程

这 foundry_agents 该包提供了两个示例代理和一个管道工作流 其独立于MCP服务器工作。

将代理部署到Azure AI Foundry

在您的Foundry项目中注册示例代理（然后它们会出现在 agents_list_agents 并且可以通过以下方式调用 agents_invoke_agent):

deploy-case-study-agent      # registers CaseStudyAgent
deploy-architecture-agent    # registers ArchitectureAgent

运行项目日志工作流

获取Microsoft客户故事，提取元数据，生成架构 图表，并将所有内容存储在向量索引中——所有这些都在一个命令中：

run-project-log-workflow \
  --url "https://www.microsoft.com/en/customers/story/25676-commerzbank-ag-azure-ai-foundry-agent-service" \
  --project "Commerzbank AI Platform"

或者从MCP服务器触发相同的管道：

Run the project log workflow for https://www.microsoft.com/en/customers/story/...

工作流程 自动使用已部署的Foundry代理 如果可用，以及 否则，将退回到直接的Azure OpenAI推理。

______________________________________________________________________

部署到Azure容器应用程序

服务器可以部署到 Azure容器应用 只需一个命令 使用 Azure开发者命令行界面（azd）.

配置什么

Infra文件夹结构

infra/
  abbreviations.json          ← Azure resource name prefixes
  main.bicep                  ← Subscription-scoped orchestrator
  main.parameters.json        ← azd parameter file
  ai/
    foundry.bicep             ← AIServices account + Foundry project + model deployments
    search.bicep              ← Azure AI Search
  app/
    server.bicep              ← MCP server Container App + identity
  core/
    host/
      vnet.bicep              ← VNet with aca-apps subnet (always deployed)
      container-apps.bicep    ← Environment + registry orchestration
      container-apps-environment.bicep  ← Managed environment (usePrivateIngress flag)
      container-app.bicep     ← Container App with health probes + role assignments
      container-app-upsert.bicep
      container-registry.bicep
    monitor/
      monitoring.bicep        ← Log Analytics + Application Insights
      loganalytics.bicep
      applicationinsights.bicep
    security/
      foundry-access.bicep    ← Azure AI Developer + Cognitive Services OpenAI User
      registry-access.bicep   ← AcrPull
      search-access.bicep     ← Search Index Data Contributor

快速部署

# 1. Login
azd auth login

# 2. Create an azd environment
azd env new foundry-mcp
azd env set AZURE_LOCATION swedencentral   # or eastus2, westus3, northcentralus

# 3. (Optional) private ingress – accessible only from within the VNet
azd env set USE_PRIVATE_INGRESS true

# 4. Provision infrastructure (no local Docker required)
azd up

azd up 将：

1. 提供所有资源（ExpressRoute、容器应用程序、Foundry、搜索、监控）
2. 跑 infra/write_env.sh 填充 .env 所有端点值

构建和部署容器

容器映像是使用Azure容器注册表（ACR）远程构建的 不需要本地Docker安装.之后 azd up 已配置 基础设施，运行：

# Build in ACR and deploy the Container App
./azd-hooks/deploy.sh foundry-mcp   # pass your azd environment name

脚本将：

1. 通过ACR远程构建Docker镜像 az acr build
2. 通过二头肌部署部署容器应用程序(infra/app/server.bicep)
3. 打印MCP服务器URL

私人入口

当 USE_PRIVATE_INGRESS=true 容器应用程序环境配置为 internal: true 并且容器应用程序入口设置为 external: falseThe 然后，MCP服务器只能从ExpressRoute内访问（例如通过跳转主机， VPN或同一环境中的另一个容器应用程序）。

将VS代码副本连接到部署的服务器

# Find the URL
cat .env | grep MCP_SERVER_URL

1. 在VS代码中打开命令面板→ MCP：添加服务器 → 超文本传输协议.
2. 输入URL .env （例如。 https:///mcp).
3. 所有10个Foundry Agent工具现在都可以在Copilot Chat中使用。

使用HTTP传输在本地运行

# Start the HTTP server (same code, same image)
uvicorn foundry_agents_mcp.server:http_app --host 0.0.0.0 --port 8000

# Test the health probe
curl http://localhost:8000/health
# → {"status":"healthy","service":"foundry-agents-mcp-server"}

监控

当以下情况发生时，OpenTetry跟踪会自动启用 APPLICATIONINSIGHTS_CONNECTION_STRING 已设置。每个MCP工具调用和HTTP 通过以下方式跟踪请求 azure-monitor-opentelemetry.

azd monitor   # open the Application Insights dashboard in the portal

拆除

azd down

______________________________________________________________________

发展

# Clone and install in editable mode
git clone https://github.com/denniszielke/foundry-agents-mcp-server
cd foundry-agents-mcp-server
pip install -e ".[dev]"

# Run locally (stdio)
python -m foundry_agents_mcp

许可证

麻省理工学院