Hub 文件

將 Spaces 作為 MCP 伺服器

Hugging Face's logo
加入 Hugging Face 社群

並獲得增強的文件體驗

開始使用

將 Spaces 作為 MCP 伺服器

您可以將任何帶有可見 MCP 標記的公開 Space 發布為可呼叫的工具,使其在任何支援 MCP 的客戶端中可用。您可以隨意新增多個 Spaces,且無需編寫任何程式碼。

設定您的 MCP 客戶端

請從您的 Hub MCP 設定中,選擇您的 MCP 客戶端(如 VSCode、Cursor、Claude Code 等),然後依照設定說明進行操作。

image/png

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

將現有的 Space 新增至您的 MCP 工具

image/png

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

image/png

從您的 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 可以打造出強大且極具創意的工作流程。

此影片展示了如何在 Claude Code 中使用 Lightricks/ltx-video-distilledResembleAI/Chatterbox 來產生帶有音訊的影片。
在 GitHub 上更新

© . This site is unofficial and not affiliated with Hugging Face, Inc.