# Spaces в качестве MCP-серверов

Вы можете **превратить любой публичный Space с видимым значком `MCP` в вызываемый инструмент**, который будет доступен в любом MCP-совместимом клиенте. Вы можете добавить столько Spaces, сколько захотите, и при этом не писать ни строчки кода.

## Настройка MCP-клиента

В [настройках Hub MCP](https://huggingface.co/settings/mcp) выберите ваш MCP-клиент (VSCode, Cursor, Claude Code и т. д.), затем следуйте инструкциям по настройке.

![image/png](/static-proxy?url=https%3A%2F%2Fcdn-uploads.huggingface.co%2Fproduction%2Fuploads%2F5f17f0a0925b9863e28ad517%2FwWm_GeuWF17OrMyJT4tMx.png)

> [!WARNING]
> Для использования инструментов MCP вам нужен действующий токен Hugging Face с правами READ. Если у вас его нет, создайте новый токен доступа "Read" здесь.

## Добавление существующего Space в ваши MCP-инструменты

![image/png](/static-proxy?url=https%3A%2F%2Fcdn-uploads.huggingface.co%2Fproduction%2Fuploads%2F5f17f0a0925b9863e28ad517%2Fex9KRpvamn84ZaOlSp_Bj.png)

1. Просматривайте совместимые [Spaces](https://huggingface.co/spaces?filter=mcp-server), чтобы найти Spaces, доступные через MCP. Также вы можете искать серый значок **MCP** на любой карточке Spaces.
2. Нажмите на значок и выберите **Add to MCP tools**, затем подтвердите действие при запросе.
3. Space должен отображаться в настройках вашего MCP Server в разделе Spaces Tools.

![image/png](/static-proxy?url=https%3A%2F%2Fcdn-uploads.huggingface.co%2Fproduction%2Fuploads%2F5f17f0a0925b9863e28ad517%2FuI4PsneUZoWn_TExhNJyt.png)

## Использование Spaces из вашего MCP-клиента 

Если ваш MCP-клиент настроен правильно, добавленные вами Spaces станут доступны сразу, без каких-либо изменений (если клиент не перезапускается, они должны появиться). Большинство MCP-клиентов отображают список загруженных инструментов, что позволяет убедиться в доступности Space.

> [!TIP]
> Для ZeroGPU Spaces ваша квота расходуется в момент вызова инструмента. Если квота исчерпана, вы можете оформить подписку PRO, чтобы получить 40 минут ежедневной квоты (в 8 раз больше, чем у пользователей бесплатного тарифа). Например, аккаунт PRO позволяет генерировать до 600 изображений в день с помощью FLUX.1-schnell.

## Создайте собственное Gradio Space, совместимое с MCP

Чтобы создать собственное пространство Space с поддержкой MCP, вам нужно [создать новое пространство 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), чтобы узнать больше.

Сначала установите Gradio с поддержкой MCP:
```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 в MCP-сервер. Дублируйте его через контекстное меню, затем просто добавьте параметр mcp_server=True в метод launch() и убедитесь, что ваши функции имеют явные аннотации типов и docstrings — вы можете использовать ИИ-инструменты, чтобы довольно легко автоматизировать этот процесс (пример сгенерированных ИИ docstrings).

## Будьте креативны, комбинируя Spaces!

Поскольку Hugging Face Spaces — это крупнейший каталог приложений на базе ИИ, в нём можно найти множество творческих инструментов, которые можно использовать в качестве MCP-инструментов. Комбинируя различные Spaces, можно создавать мощные и креативные рабочие процессы.

  
    
    
  
    В этом видео показано использование Lightricks/ltx-video-distilled и ResembleAI/Chatterbox в Claude Code для генерации видео со звуком.