Hub documentation
SpacesをMCPサーバーとして
SpacesをMCPサーバーとして
表示可能なMCPバッジを持つ公開Spaceを、呼び出し可能なツールとして公開できます。このツールは、MCP互換のすべてのクライアントで利用可能になり、コードを1行も書かずに、任意の数のSpaceを追加できます。
MCPクライアントのセットアップ
Hub MCP 設定から、MCP クライアント(VSCode、Cursor、Claude Code など)を選択し、セットアップ手順に従ってください。

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

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

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を組み合わせることで、強力かつクリエイティブなワークフローを実現できます。