Gradio 5.38.0 MCP 服务器改进

Gradio 5.38.0 版在其模型上下文协议（MCP）服务器实现中引入了五项主要增强，简化了开发者在 Hugging Face Spaces 上构建、托管和集成 AI 驱动工具的流程。

无缝本地文件支持

之前，远程 Gradio MCP 服务器要求输入文件（如图像、视频或音频）必须通过公共 URL 访问，因为服务器和客户端托管在不同的机器上。为消除手动在线托管文件的步骤，Gradio 现在加入了一个 “File Upload” MCP 服务器。

该专用服务器允许 LLM 代理直接向 Gradio 应用上传文件。当 Gradio MCP 服务器中的工具需要文件输入时，连接文档现在会自动提供如何初始化 “File Upload” MCP 服务器的说明，以便完成此过程。

实时进度通知

为提升长时间运行的 AI 任务期间的用户体验，Gradio 现在向 MCP 客户端流式传输进度通知。这样用户可以实时监控工具的执行状态。建议开发者在其 MCP 工具中发出这些进度状态，以充分利用此功能。

自动化 OpenAPI 规范转换

Gradio 引入了 gr.load_openapi 函数，以自动化将现有 RESTful API 集成到 LLM 环境中。之前，开发者必须手动将 API 端点映射到 MCP 工具，这一过程常常耗时且易出错。

使用 gr.load_openapi，开发者可以直接从 OpenAPI 架构（机器可读的 JSON 文件）创建 Gradio 应用。通过使用 mcp_server=True 启动应用，Gradio 会自动将 OpenAPI 规范转换为 MCP 服务器，使业务后端能够通过一行代码集成到任何兼容 MCP 的 LLM 中。

通过 gr.Header 增强身份验证

为简化代表用户调用服务时的身份验证头管理，Gradio 现在支持在 MCP 服务器参数中使用 gr.Header 类型。

当开发者将参数类型声明为 gr.Header 时，Gradio 会自动从传入请求中提取相应的头信息并传递给函数。此外，MCP 连接文档会自动显示所需的头信息，明确告知用户连接服务器时必须提供哪些凭证。

可自定义工具描述

虽然 Gradio 会自动根据函数名和文档字符串生成工具描述，但开发者现在可以使用 api_description 参数显式覆盖这些描述。这使得对工具向 LLM 的描述拥有更精确的控制，确保代理更准确地理解工具的用途和应用。