这是一个为Azure AI Foundry设计的模型上下文协议服务器,为模型、知识库、评估等提供统一工具集。
Azure AI Foundry的MCP服务器(实验性)已迁移至云端,现称为Foundry MCP服务器(预览版)。请参阅官方公开文档开始使用Foundry MCP服务器(预览版)。本GitHub仓库包含已过期的实验性服务器实现信息,将不再更新。请改用新的远程托管和管理的Foundry 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端点的发现和自动化 |
此GitHub模板包含MCP服务器配置和所有必需依赖项的最小设置,使您可以轻松开始自己的项目。
这将帮助您在VS Code环境的用户设置中自动配置MCP服务器。 运行服务器需要您的环境中已安装
uvx。
按照安装uv指南安装uv
在VS Code中新建工作区
(可选)在工作区根目录创建.env文件设置环境变量
在工作区根目录创建.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"
]
}
}
}

点击.vscode/mcp.json文件中的Start按钮启动服务器
在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项目凭证有效
- 仅进行文本质量评估时,只需配置OpenAI端点和密钥即可
MIT许可证。详见LICENSE文件。