Hub 文件
將 Spaces 作為 MCP 伺服器
並獲得增強的文件體驗
開始使用
將 Spaces 作為 MCP 伺服器
您可以將任何帶有可見 MCP 標記的公開 Space 發布為可呼叫的工具,使其在任何支援 MCP 的客戶端中可用。您可以隨意新增多個 Spaces,且無需編寫任何程式碼。
設定您的 MCP 客戶端
請從您的 Hub MCP 設定中,選擇您的 MCP 客戶端(如 VSCode、Cursor、Claude Code 等),然後依照設定說明進行操作。

您需要一個具有 READ(讀取)權限的有效 Hugging Face Token 才能使用 MCP 工具。如果您沒有,請點此建立新的「讀取」存取權杖 (Read access token)。
將現有的 Space 新增至您的 MCP 工具

- 瀏覽相容的 Spaces 以尋找可透過 MCP 使用的 Spaces。您也可以查看 Space 卡片上是否有灰色的 MCP 標記。
- 點擊該標記並選擇 Add to MCP tools(新增至 MCP 工具),然後在系統詢問時進行確認。
- 該 Space 隨後應會列在您的「MCP 伺服器設定」中的「Spaces 工具」區塊內。

從您的 MCP 客戶端使用 Spaces
如果您的 MCP 客戶端設定正確,您新增的 Spaces 將會立即生效,無需進行任何更改(如果沒有出現,請重新啟動客戶端)。大多數 MCP 客戶端會列出目前已載入的工具,您可以藉此確認該 Space 是否可用。
對於 ZeroGPU Spaces,當您呼叫工具時會消耗您的配額。如果配額用盡,您可以訂閱 PRO 版以獲得每日 40 分鐘的配額(比免費使用者多 8 倍)。例如,您的 PRO 帳戶讓您每天最多可以使用 FLUX.1-schnell 生成 600 張影像。
建立您專屬的 MCP 相容 Gradio Space
要建立您自己的 MCP 啟用型 Space,您需要建立一個新的 Gradio Space,並確保在程式碼中啟用 MCP 支援。您可以從 Gradio Spaces 開始入門,並務必參考詳細的 MCP 指南以獲取更多資訊。
首先,安裝支援 MCP 的 Gradio。
pip install "gradio[mcp]"然後建立您的應用程式,並確保包含清晰的型別提示 (type hints) 和說明文件字串 (docstrings)。
import gradio as gr
def letter_counter(word: str, letter: str) -> int:
"""Count occurrences of a letter in a word.
Args:
word: The word to search in
letter: The letter to count
Returns:
Number of times the letter appears in the word
"""
return word.lower().count(letter.lower())
demo = gr.Interface(fn=letter_counter,
inputs=["text", "text"],
outputs="number")
demo.launch(mcp_server=True) # exposes an MCP schema automatically將應用程式推送到 Gradio Space,它將會自動獲得 MCP 標記。此後,任何人都可以透過單次點擊將其新增為工具。
將現有的 Gradio Space 轉換為 MCP 伺服器也非常簡單。從內容選單中選擇複製 (Duplicate),然後在您的
launch()方法中新增mcp_server=True參數,並確保您的函式具有清晰的型別提示和說明文件字串——您可以輕鬆使用 AI 工具來自動化此流程(AI 生成說明文件字串的範例)。
混合使用 Spaces,發揮創意!
由於 Hugging Face Spaces 是最大的 AI 應用程式目錄,您可以找到許多可以作為 MCP 工具使用的創意工具。混搭不同的 Spaces 可以打造出強大且極具創意的工作流程。