Hub 文件
Spaces 作為 MCP 伺服器
加入 Hugging Face 社群
並獲得增強的文件體驗
開始使用
Spaces 作為 MCP 伺服器
您可以將**任何帶有可見 `MCP` 徽章的公共 Space 暴露為一個可呼叫的工具**，該工具將在任何 MCP 相容客戶端中可用，您可以新增任意數量的 Space，無需編寫任何程式碼。
設定您的 MCP 客戶端
在您的 Hub MCP 設定 中，選擇您的 MCP 客戶端（VSCode、Cursor、Claude Code 等），然後按照設定說明進行操作。
您需要一個具有 讀取 許可權的有效 Hugging Face 令牌才能使用 MCP 工具。如果您沒有，在此處建立一個新的“讀取”訪問令牌。
將現有 Space 新增到您的 MCP 工具
- 瀏覽相容的 Spaces，查詢可透過 MCP 使用的 Space。您也可以在任何 Space 卡片上查詢灰色 MCP 徽章。
- 點選徽章並選擇 新增到 MCP 工具，然後在提示時確認。
- 該 Space 應列在您 MCP 伺服器設定的 Space 工具部分。
從您的 MCP 客戶端使用 Spaces
如果您的 MCP 客戶端配置正確，您新增的 Spaces 將立即可用，無需進行任何更改（如果未顯示，請重啟客戶端，它應該就會出現）。大多數 MCP 客戶端會列出當前載入的工具，以便您可以確保 Space 可用。
對於 ZeroGPU Spaces，當呼叫工具時將使用您的配額，如果您的配額用盡，您可以訂閱 PRO 以獲得每天 25 分鐘的配額（比免費使用者多 8 倍）。例如，您的 PRO 賬戶允許您每天使用 FLUX.1-schnell 生成多達 600 張影像。
構建您自己的 MCP 相容 Gradio Space
要建立您自己的支援 MCP 的 Space，您需要建立一個新的 Gradio Space，然後確保在程式碼中啟用 MCP 支援。從Gradio Spaces 入門，並務必檢視詳細的 MCP 指南以獲取更多詳細資訊。
首先，安裝支援 MCP 的 Gradio
pip install "gradio[mcp]"然後使用清晰的型別提示和文件字串建立您的應用程式
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 伺服器也非常簡單。從上下文選單中複製它，然後只需將
mcp_server=True 引數新增到您的 launch() 方法中，並確保您的函式具有清晰的型別提示和文件字串 - 您可以非常輕鬆地使用 AI 工具自動化此過程（示例：AI 生成的文件字串）。透過混合 Spaces 來發揮創意！
由於 Hugging Face Spaces 是最大的 AI 應用程式目錄，您可以找到許多可作為 MCP 工具的創意工具。混合和匹配不同的 Spaces 可以帶來強大而富有創意的工作流程。