Hub documentation

SpacesをMCPサーバーとして

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

SpacesをMCPサーバーとして

表示可能なMCPバッジを持つ公開Spaceを、呼び出し可能なツールとして公開できます。このツールは、MCP互換のすべてのクライアントで利用可能になり、コードを1行も書かずに、任意の数のSpaceを追加できます。

MCPクライアントのセットアップ

Hub MCP 設定から、MCP クライアント(VSCode、Cursor、Claude Code など)を選択し、セットアップ手順に従ってください。

image/png

MCPツールを使用するには、READ権限を持つ有効なHugging Faceトークンが必要です。お持ちでない場合は、こちらで新しい「Read」アクセストークンを作成してください。

既存のSpaceをMCPツールに追加する

image/png

  1. 互換性のあるSpacesを閲覧して、MCP経由で使用できるSpacesを探してください。また、任意のSpacesカードに付いているグレーのMCPバッジを探すこともできます。
  2. バッジをクリックし、Add to MCP tools を選択して、確認を求められたら確認してください。
  3. Space は、Spaces Tools セクションの MCP Server 設定にリスト表示されるはずです。

image/png

MCPクライアントからSpacesを使用する

MCPクライアントが正しく設定されている場合、追加したSpacesは、何も変更せずにすぐに利用可能になります(クライアントが再起動されない場合、表示されるはずです)。ほとんどのMCPクライアントは、現在読み込まれているツールをリスト表示するため、Spaceが利用可能であることを確認できます。

ZeroGPU Spaces では、ツールが呼び出された際にクォータが消費されます。クォータを使い切った場合は、PRO にサブスクライブすることで、1 日 40 分間のクォータ(無料ユーザーの 8 倍)を利用できます。例えば、PRO アカウントでは、FLUX.1-schnell を使用して 1 日最大 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サーバーに変換するのも非常に簡単です。コンテキストメニューから複製し、launch()メソッドにmcp_server=Trueパラメータを追加するだけです。また、関数に明確な型ヒントとドキュメント文字列(docstring)があることを確認してください。AIツールを活用すれば、これを簡単に自動化できます(AIが生成したdocstringの例)。

Spacesを組み合わせることで、クリエイティブなアイデアを実現しましょう!

Hugging Face Spacesは最大のAIアプリのディレクトリであるため、MCPツールとして使用できる多くのクリエイティブなツールを見つけることができます。異なるSpacesを組み合わせることで、強力かつクリエイティブなワークフローを実現できます。

この動画では、Claude Code で Lightricks/ltx-video-distilled と ResembleAI/Chatterbox を使用して、音声付きの動画を生成する方法を示しています。
Update on GitHub