# SpacesをMCPサーバーとして

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

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

[Hub MCP 設定](https://huggingface.co/settings/mcp)から、MCP クライアント（VSCode、Cursor、Claude Code など）を選択し、セットアップ手順に従ってください。

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/wWm_GeuWF17OrMyJT4tMx.png)

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

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

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/ex9KRpvamn84ZaOlSp_Bj.png)

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

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/uI4PsneUZoWn_TExhNJyt.png)

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

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

> [!TIP]
> ZeroGPU Spaces では、ツールが呼び出された際にクォータが消費されます。クォータを使い切った場合は、PRO にサブスクライブすることで、1 日 40 分間のクォータ（無料ユーザーの 8 倍）を利用できます。例えば、PRO アカウントでは、FLUX.1-schnell を使用して 1 日最大 600 枚の画像を生成できます。

## MCP互換のGradio Spaceを自分で構築する

独自のMCP対応Spaceを作成するには、[新しいGradio Spaceを作成](https://huggingface.co/new-space?sdk=gradio)し、コード内でMCPサポートを有効にしてください。[Gradio Spaces](https://huggingface.co/docs/hub/en/spaces-sdks-gradio)から始め、詳細については[詳細なMCPガイド](https://www.gradio.app/guides/building-mcp-server-with-gradio)を参照してください。

まず、MCP対応のGradioをインストールします:
```bash
pip install "gradio[mcp]"
```

その後、明確な型ヒントとドキュメント文字列を付けてアプリを作成します:

```python
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**バッジが付与されます。その後、誰でもワンクリックでツールとして追加できます。

> [!TIP]
> 既存の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 を使用して、音声付きの動画を生成する方法を示しています。