Spaces como servidores MCP

Você pode expor qualquer Space público que tenha um selo MCP visível como uma ferramenta chamável que estará disponível em qualquer cliente compatível com MCP, e você pode adicionar quantos Spaces quiser e sem escrever uma única linha de código.

Configure seu cliente MCP

A partir das suas configurações do MCP no Hub, selecione seu cliente MCP (VSCode, Cursor, Claude Code, etc.) e, em seguida, siga as instruções de configuração.

Você precisa de um token do Hugging Face válido com permissões de READ para usar as ferramentas MCP. Se você não tiver um, crie um novo token de acesso “Read” aqui.

Adicione um Space existente às suas ferramentas MCP

1. Navegue pelos Spaces compatíveis para encontrar Spaces que podem ser usados via MCP. Você também pode procurar o selo cinza MCP em qualquer cartão de Spaces.
2. Clique no selo e escolha Add to MCP tools e, em seguida, confirme quando solicitado.
3. O Space deve estar listado nas configurações do seu MCP Server, na seção Spaces Tools.

Use Spaces a partir do seu cliente MCP

Se o seu cliente MCP estiver configurado corretamente, os Spaces que você adicionou ficarão disponíveis imediatamente, sem a necessidade de alterar nada (caso ele não reinicie o seu cliente, ele deve aparecer). A maioria dos clientes MCP lista as ferramentas que estão atualmente carregadas, para que você possa verificar se o Space está disponível.

Para os Spaces ZeroGPU, sua cota será utilizada quando a ferramenta for chamada. Se você esgotar sua cota, pode assinar o PRO para obter 40 minutos de cota diária (8x mais cota do que os usuários gratuitos). Por exemplo, sua conta PRO permite gerar até 600 imagens por dia usando FLUX.1-schnell.

Crie seu próprio Espaço Gradio compatível com MCP

Para criar seu próprio Space habilitado para MCP, você precisa criar um novo Space do Gradio e, em seguida, garantir que o suporte a MCP esteja habilitado no código. Comece com Gradio Spaces e verifique o guia detalhado de MCP para mais detalhes.

Primeiro, instale o Gradio com suporte a MCP:

pip install "gradio[mcp]"

Em seguida, crie seu aplicativo com type hints e docstrings claros:

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

Envie o aplicativo para um Gradio Space e ele receberá automaticamente o selo MCP. Qualquer pessoa poderá adicioná-lo como ferramenta com um único clique.

Também é bastante fácil converter um Space do Gradio existente em um servidor MCP. Duplico-o pelo menu de contexto e, em seguida, basta adicionar o parâmetro mcp_server=True ao seu método launch(), garantindo que suas funções tenham type hints e docstrings claros - você pode usar ferramentas de IA para automatizar isso com bastante facilidade (exemplo de docstrings geradas por IA).

Seja criativo misturando Spaces!

Como o Hugging Face Spaces é o maior diretório de aplicativos de IA, você pode encontrar muitas ferramentas criativas que podem ser usadas como ferramentas MCP. Combinar e alternar entre diferentes Spaces pode resultar em fluxos de trabalho poderosos e criativos.