首页
学习
活动
专区
圈层
工具
发布
MCP广场 >详情页
连接Foundry2026-10-23235分享添加福利群:解决AI开发者的「MCP实战痛点」
在任何 MCP 客户端中启用与 Azure AI Agent 的连接,允许用户通过对话界面利用 Azure AI Foundry 的模型和知识工具,例如 Azure AI 搜索和必应网络 grounding。
By azure-ai-foundry
2026-10-23235
github
详情内容

与Azure AI Foundry交互的MCP服务器(实验性)

这是一个为Azure AI Foundry设计的模型上下文协议服务器,为模型、知识库、评估等提供统一工具集。

GitHub关注者 GitHub复刻数 GitHub星标数

Azure AI社区Discord

重要通知

Azure AI Foundry的MCP服务器(实验性)已迁移至云端,现称为Foundry MCP服务器(预览版)。请参阅官方公开文档开始使用Foundry MCP服务器(预览版)。本GitHub仓库包含已过期的实验性服务器实现信息,将不再更新。请改用新的远程托管和管理的Foundry MCP服务器,它具有以下优势:

  • AI工具编排的云托管接口:Foundry MCP服务器(预览版)为符合MCP协议的客户端提供安全、可扩展的端点。您无需部署基础设施,即可实现无缝集成和多智能体场景。
  • 身份验证与访问控制:服务器通过Microsoft Entra ID强制执行身份验证和授权。所有操作都在已认证用户的权限范围内执行(On-Behalf-Of流程)。
  • 面向场景的可扩展工具:MCP服务器提供不断增长的工具集,用于在Microsoft Foundry中对模型、部署、评估和智能体进行读写操作。这些工具可扩展,让开发者和智能体无需了解后端API或数据模式即可与服务交互。
  • 加速智能体与开发者生产力:通过自然语言工作流(借助MCP客户端和大语言模型)实现快速工具发现和调用,简化开发和多智能体编排。

本仓库剩余部分(包括代码库)解释的是现已弃用的与Azure AI Foundry(实验性)交互的MCP服务器。


可用工具

能力:模型

类别 工具 描述
探索 list_models_from_model_catalog 从Azure AI Foundry目录获取支持的模型列表
list_azure_ai_foundry_labs_projects 获取Microsoft Research在Azure AI Foundry Labs中提供的最先进AI模型列表
get_model_details_and_code_samples 从Azure AI Foundry目录获取特定模型的详细信息
构建 get_prototyping_instructions_for_github_and_labs 提供开始使用Azure AI Foundry和Azure AI Foundry Labs模型的全面指导和设置说明
部署 get_model_quotas 获取特定Azure区域的模型配额
create_azure_ai_services_account 创建Azure AI服务账户
list_deployments_from_azure_ai_services 从Azure AI服务获取部署列表
deploy_model_on_ai_services 在Azure AI服务上部署模型
create_foundry_project 创建新的Azure AI Foundry项目

能力:知识库

类别 工具 描述
索引 list_index_names 从AI搜索服务获取所有索引名称
list_index_schemas 从AI搜索服务获取所有索引模式
retrieve_index_schema 从AI搜索服务获取特定索引的模式
create_index 创建新索引
modify_index 修改现有索引的定义
delete_index 删除现有索引
文档 add_document 向索引添加文档
delete_document 从索引中删除文档
查询 query_index 搜索特定索引以获取匹配文档
get_document_count 返回索引中的文档总数
索引器 list_indexers 从AI搜索服务获取所有索引器名称
get_indexer 从AI搜索服务获取特定索引器的完整定义
create_indexer 在搜索服务中创建带有技能、索引和数据源的新索引器
delete_indexer 按名称从AI搜索服务删除索引器
数据源 list_data_sources 从AI搜索服务获取所有数据源名称
get_data_source 获取特定数据源的完整定义
技能集 list_skill_sets 从AI搜索服务获取所有技能集名称
get_skill_set 获取特定技能集的完整定义
内容 fk_fetch_local_file_contents 获取本地文件路径的内容(示例JSON、文档等)
fk_fetch_url_contents 获取URL的内容(示例JSON、文档等)

能力:评估

类别 工具 描述
评估工具 list_text_evaluators 列出所有可用的文本评估器
list_agent_evaluators 列出所有可用的智能体评估器
get_text_evaluator_requirements 显示每个文本评估器的输入要求
get_agent_evaluator_requirements 显示每个智能体评估器的输入要求
文本评估 run_text_eval 在JSONL文件或内容上运行一个或多个文本评估器
format_evaluation_report 将评估输出转换为可读的Markdown报告
智能体评估 agent_query_and_evaluate 查询智能体并使用选定评估器评估其响应。端到端智能体评估
run_agent_eval 使用特定数据(查询、响应、工具调用、定义)评估单个智能体交互
智能体服务 list_agents 列出配置项目中所有可用的Azure AI智能体
connect_agent 向指定智能体发送查询
query_default_agent 查询环境变量中定义的默认智能体

能力:微调

类别 工具 描述
微调 fetch_finetuning_status 获取特定微调作业的详细状态和元数据,包括作业状态、模型、创建和完成时间、超参数和任何错误
list_finetuning_jobs 列出资源中的所有微调作业,返回作业ID及其当前状态以便跟踪和管理
get_finetuning_job_events 获取特定微调作业的所有事件时间序列,包括每个训练步骤、评估和完成的时间戳和详细消息
get_finetuning_metrics 获取特定微调作业的训练和评估指标,包括损失曲线、准确度和其他相关性能指标
list_finetuning_files 列出Azure OpenAI中可用于微调的所有文件,包括文件ID、名称、用途和状态
execute_dynamic_swagger_action 执行从Swagger规范动态生成的任何工具,允许灵活调用API以实现高级场景
list_dynamic_swagger_tools 列出从Swagger规范动态注册的所有工具,实现可用API端点的发现和自动化

提示示例

模型

探索模型

  • 你如何帮助我找到合适的模型?
  • 我可以使用Azure AI Foundry中的哪些模型?
  • Azure AI Foundry中有哪些OpenAI模型可用?
  • Azure AI Foundry中最受欢迎的模型是哪些?给我挑选10个模型。
  • 哪些模型适合推理?给我展示一些例子,分成两类:一类是大模型,一类是小模型。
  • 你能比较Phi模型并解释差异吗?
  • 给我展示Phi-4-reasoning的模型卡片。
  • 你能展示如何测试模型吗?
  • Azure AI Foundry中的免费playground是什么意思?
  • 我可以用GitHub令牌测试模型吗?
  • 展示最新支持GitHub令牌的模型。
  • Azure AI Foundry中的模型发布者是谁?
  • 展示来自Meta的模型。
  • 展示使用MIT许可证的模型。

构建原型

  • 你能描述如何帮助我使用模型构建原型吗?
  • 描述如何使用我的GitHub令牌构建使用OpenAI模型的原型。先不要尝试创建。
  • 推荐几个使用模型构建原型的场景。
  • 告诉我关于Azure AI Foundry Labs的信息。
  • 告诉我更多关于Magentic One的信息
  • 什么是Omniparser,它有哪些潜在用例?
  • 你能帮助我使用Omniparser构建原型吗?

部署OpenAI模型

  • 你能帮助我部署OpenAI模型吗?
  • 在Azure AI Foundry上部署OpenAI模型需要哪些步骤?
  • 你能帮助我理解如何使用GitHub令牌在Azure AI Foundry上使用OpenAI模型吗?可以用于生产环境吗?
  • 我已经有一个Azure AI服务资源。可以在上面部署OpenAI模型吗?
  • Azure AI Foundry上OpenAI模型的配额是什么意思?
  • 获取我当前AI服务资源的配额信息。

使用GitHub Copilot快速入门

使用模板

此GitHub模板包含MCP服务器配置和所有必需依赖项的最小设置,使您可以轻松开始自己的项目。

在VS Code中安装

这将帮助您在VS Code环境的用户设置中自动配置MCP服务器。 运行服务器需要您的环境中已安装uvx。

手动设置

  1. 按照安装uv指南安装uv

  2. 在VS Code中新建工作区

  3. (可选)在工作区根目录创建.env文件设置环境变量

  4. 在工作区根目录创建.vscode/mcp.json文件

    {
        "servers": {
            "mcp_foundry_server": {
                "type": "stdio",
                "command": "uvx",
                "args": [
                    "--prerelease=allow",
                    "--from",
                    "git+https://github.com/azure-ai-foundry/mcp-foundry.git",
                    "run-azure-ai-foundry-mcp",
                    "--envFile",
                    "${workspaceFolder}/.env"
                ]
            }
        }
    }
    
  5. 点击.vscode/mcp.json文件中的Start按钮启动服务器

  6. 在Agent模式下打开GitHub Copilot聊天窗口开始提问

有关MCP服务器设置的更多细节,请参阅高级设置示例

环境变量设置

为了安全地向MCP服务器传递API密钥、端点等敏感信息,您可以使用环境变量。这对于需要身份验证或访问外部服务的工具尤为重要。

您可以在项目根目录的.env文件中设置这些环境变量。在配置MCP服务器时指定.env文件路径,服务器启动时将自动加载这些变量。

参考示例.env文件查看配置样例。

类别 变量名 是否必填 说明
模型 GITHUB_TOKEN 否 用于免费测试模型的GitHub令牌(受速率限制)
知识库 AZURE_AI_SEARCH_ENDPOINT 必填 Azure AI搜索服务端点,格式为:https://<服务名称>.search.windows.net/
AZURE_AI_SEARCH_API_VERSION 否 使用的API版本,默认为2025-03-01-preview
SEARCH_AUTHENTICATION_METHOD 必填 认证方式:service-principal或api-search-key
AZURE_TENANT_ID 使用service-principal时必填 Azure AD租户ID
AZURE_CLIENT_ID 使用service-principal时必填 服务主体(应用注册)ID
AZURE_CLIENT_SECRET 使用service-principal时必填 服务主体密钥
AZURE_AI_SEARCH_API_KEY 使用api-search-key时必填 Azure AI搜索服务API密钥
评估 EVAL_DATA_DIR 必填 JSONL评估数据集路径
AZURE_OPENAI_ENDPOINT 文本质量评估时必填 Azure OpenAI服务端点
AZURE_OPENAI_API_KEY 文本质量评估时必填 Azure OpenAI API密钥
AZURE_OPENAI_DEPLOYMENT 文本质量评估时必填 部署名称(如gpt-4o)
AZURE_OPENAI_API_VERSION 文本质量评估时必填 OpenAI API版本
AZURE_AI_PROJECT_ENDPOINT 代理服务时必填 用于Azure AI代理查询和评估

[!注意] 模型

  • GITHUB_TOKEN用于通过GitHub API测试模型。如果只是浏览Foundry目录中的模型则不需要。

知识库

  • 参考创建搜索服务了解如何配置搜索服务
  • Azure AI搜索支持多种认证方式,可选择Microsoft Entra认证或密钥认证,具体取决于安全需求和Azure环境
  • 参考认证方式了解搜索服务的认证方法

评估

  • 使用代理工具或安全评估器时,请确保Azure项目凭证有效
  • 仅进行文本质量评估时,只需配置OpenAI端点和密钥即可

许可证

MIT许可证。详见LICENSE文件。

领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档