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 的描述方式，確保代理能更準確地理解工具的目的與應用。