Hugging Face MCP Server

Hugging Face MCP(Model Context Protocol) Server는 MCP 호환이 가능한 AI 어시스턴트(예: Codex, Cursor, VS Code 확장, Zed, ChatGPT, Claude Desktop)를 Hugging Face Hub에 직접 연결해 줘요. 연결되면 어시스턴트가 에디터, 채팅, CLI 안에서 Hub 리소스를 검색·탐색하고 커뮤니티 도구를 사용할 수 있어요.

출처: 문서

본문

Hugging Face MCP (Model Context Protocol) Server는 MCP 호환 AI 어시스턴트(예: Codex, Cursor, VS Code 확장, Zed, ChatGPT 또는 Claude Desktop)를 Hugging Face Hub에 직접 연결해요. 연결되면 어시스턴트가 Hub 리소스를 검색·탐색하고 커뮤니티 도구를 사용할 수 있어요 — 전부 에디터, 채팅 또는 CLI 안에서요.

무엇을 할 수 있나요?

Hub 리소스 검색·탐색: 모델, 데이터셋, Spaces, 논문 등
자연어 쿼리로 Hugging Face 문서 검색
Jobs 예약·실행과 샌드박스 사용
Spaces에 호스팅된 MCP 호환 Gradio 앱을 통해 커뮤니티 도구 실행
메타데이터, 링크, 컨텍스트와 함께 결과를 어시스턴트로 가져오기

시작하기

로그인한 상태에서 MCP 설정을 열어요.
클라이언트 선택: MCP 호환 클라이언트(예: Cursor, VS Code, Zed, Claude Desktop)를 선택해요. 페이지가 클라이언트별 지침과 복사-붙여넣기 가능한 구성 스니펫을 보여줘요.
붙여넣고 재시작: 스니펫을 클라이언트의 MCP 구성에 복사하고 저장한 뒤 클라이언트를 재시작/리로드해요. 클라이언트에 연결된 MCP 서버로 "Hugging Face"(또는 유사한 이름)가 나열되는 걸 볼 수 있을 거예요.

[!TIP] 설정 페이지가 클라이언트가 기대하는 정확한 구성을 생성해요. 손으로 구성하는 것보다 이걸 쓰세요.

MCP Settings Example

서버 사용하기

연결한 뒤 어시스턴트에게 Hugging Face 도구를 사용하라고 요청해요. 예시 프롬프트:

"Search Hugging Face models for Qwen 3.6 Quantizations."
"Find a Space that can transcribe audio files."
"Show datasets about weather time-series."
"Create a 1024 x 1024 image of a cat ghibli style."
"How do I use LoRA adapters with PEFT?" (Documentation Semantic Search 사용)
"Find papers about vision-language models."

어시스턴트가 MCP Server가 공개한 도구를 사용해 Hub를 탐색하고(다음 섹션에서 보여줄 선택한 Spaces 포함) 결과(제목, 소유자, 다운로드 수, 링크 등)를 반환해요. 그런 다음 Hub에서 리소스를 열거나 같은 채팅에서 계속 반복할 수 있어요.

HF MCP with Spaces in VS Code

내장 도구

대부분의 Hub 작업은 내장 hf_fs 도구로 효율적으로 완료할 수 있어요. 어시스턴트가 Documents와 Spaces의 시맨틱 검색을 포함해 Hub를 효율적으로 탐색하게 해줘요.

MCP 설정 페이지에서 추가 도구를 구성할 수 있어요.

도구	설명
Contribute Repos	생성한 저장소에 파일 만들고 쓰기
Sandboxes	Sandbox 생성·사용: Sandbox 파일 관리 포함
Run and Manage Jobs	Hugging Face 인프라에서 Jobs 실행·모니터링·스케줄링

[!TIP] 실험적 도구가 때때로 추가돼요. 사용해 보고 경험을 개선하는지 여기에 피드백을 남겨 주세요.

커뮤니티 도구 추가 (Spaces)

커뮤니티가 만든 MCP 호환 Gradio Spaces로 설정을 확장할 수 있어요:

MCP 지원 Spaces 탐색 여기.
Hugging Face의 MCP 설정에 해당 Space 추가 여기.

Gradio MCP 앱은 함수를 도구(인자와 설명 포함)로 노출해 어시스턴트가 직접 호출할 수 있어요. 추가한 새 도구를 인식하도록 클라이언트를 재시작하거나 새로고침해 주세요.

image/png

Spaces를 MCP 서버로 사용하는 전용 가이드는 여기에서 확인해요.

Spaces 옵션

MCP 설정에서 Spaces 작동 방식을 커스터마이즈하는 여러 옵션을 제공해요:

옵션	설명
Dynamic Spaces	런타임에 MCP Spaces를 동적으로 호출. 활성화하면 어시스턴트가 수동 추가 없이 MCP 호환 Spaces를 즉시 발견·사용할 수 있어요.
Remove Embedded Images	Gradio Spaces가 생성한 임베딩 이미지를 제거. MCP 클라이언트의 이미지 지원이 제한적이거나 텍스트 전용 응답을 원할 때 유용해요.

더 알아보기 (Learn more)

설정 및 클라이언트 셋업: https://huggingface.co/settings/mcp
체인지로그 공지: https://huggingface.co/changelog/hf-mcp-server
Hugging Face MCP Server: https://huggingface.co/mcp
Gradio Spaces로 나만의 MCP Server 만들기: https://www.gradio.app/guides/building-mcp-server-with-gradio

더 알아보기 (Learn more)

MCP 설정 페이지가 클라이언트별로 완성된 구성 스니펫을 생성하니 그걸 그대로 쓰는 게 가장 좋아요.
커뮤니티가 만든 MCP 호환 Gradio Spaces를 추가해 기능을 확장할 수 있어요.