Space를 MCP 서버로 사용하기

Space를 MCP 서버로 사용하기 (Spaces as MCP servers)

MCP 배지가 보이는 어떤 공개 Space든 호출 가능한 도구로 노출해 MCP 호환 클라이언트에서 사용할 수 있어요. 코드 한 줄도 쓰지 않고 원하는 만큼 많은 Space를 추가할 수 있습니다.

출처: 문서

본문

MCP 배지가 표시된 공개 Space를 호출 가능한 도구로 노출해 어떤 MCP 호환 클라이언트에서든 사용할 수 있게 할 수 있어요. 원하는 만큼 많은 Space를, 코드 한 줄도 쓰지 않고 추가할 수 있습니다.

MCP 클라이언트 설정 (Setup your MCP Client)

Hub MCP 설정에서 내 MCP 클라이언트(VSCode, Cursor, Claude Code 등)를 선택한 뒤 설정 지침을 따르세요.

image/png

[!WARNING] MCP 도구를 사용하려면 READ 권한이 있는 유효한 Hugging Face 토큰이 필요합니다. 없다면 여기서 새 "Read" 액세스 토큰을 만드세요.

기존 Space를 MCP 도구에 추가 (Add an existing Space to your MCP tools)

image/png

  1. 호환 Spaces를 탐색해 MCP로 사용할 수 있는 Space를 찾으세요. 어떤 Spaces 카드의 회색 MCP 배지에서도 찾을 수 있어요.
  2. 배지를 클릭하고 Add to MCP tools를 선택한 뒤 확인합니다.
  3. Space가 MCP Server 설정의 Spaces Tools 섹션에 나열되어야 해요.

image/png

MCP 클라이언트에서 Space 사용 (Use Spaces from your MCP client)

MCP 클라이언트가 올바르게 구성되었다면, 추가한 Space는 아무것도 바꾸지 않고 즉시 사용할 수 있어요(안 되면 클라이언트를 재시작하면 나타날 거예요). 대부분의 MCP 클라이언트는 현재 로드된 도구를 나열하므로 Space가 사용 가능한지 확인할 수 있습니다.

[!TIP] ZeroGPU Space의 경우 도구를 호출할 때 내 쿼터가 사용됩니다. 쿼터가 소진되면 PRO에 구독해 일일 40분 쿼터(무료 사용자의 8배)를 받을 수 있어요. 예를 들어 PRO 계정은 FLUX.1-schnell로 하루 최대 600장의 이미지를 생성할 수 있습니다.

나만의 MCP 호환 Gradio Space 만들기 (Build your own MCP-compatible Gradio Space)

MCP 지원 Space를 만들려면 새 Gradio Space를 만들고 코드에서 MCP 지원을 활성화해야 합니다. Gradio Spaces로 시작하고, 자세한 내용은 상세 MCP 가이드를 확인하세요.

먼저 MCP 지원과 함께 Gradio를 설치합니다:

pip install "gradio[mcp]"

그런 다음 명확한 타입 힌트와 docstring으로 앱을 만드세요:

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 예시).

Space를 섞어 창의적으로 활용하기 (Be creative by mixing Spaces!)

Hugging Face Spaces는 가장 큰 AI 앱 디렉터리이므로 MCP 도구로 사용할 수 있는 창의적인 도구를 많이 찾을 수 있어요. 서로 다른 Space를 섞고 조합하면 강력하고 창의적인 워크플로가 탄생할 수 있습니다.

이 비디오는 Claude Code에서 Lightricks/ltx-video-distilled와 ResembleAI/Chatterbox를 사용해 오디오가 있는 비디오를 생성하는 모습을 보여줍니다.

더 알아보기 (Learn more)

MCP 배지가 있는 공개 Space는 코드 없이 MCP 호환 클라이언트(Claude Code, Cursor 등)의 도구로 추가할 수 있어요. Hub MCP 설정에서 클라이언트를 고르고 READ 토큰으로 인증한 뒤, 배지를 클릭해 Add to MCP tools를 선택하세요. 나만의 MCP Space는 gradio[mcp] 설치 후 demo.launch(mcp_server=True)로 만들 수 있고, ZeroGPU 호출은 PRO 쿼터를 사용합니다.