Hub documentation
Hugging Face MCP 서버
Hugging Face MCP 서버
Hugging Face MCP(Model Context Protocol) Server는 MCP 호환 AI 어시스턴트(예: Codex, Cursor, VS Code 확장 프로그램, Zed, ChatGPT 또는 Claude Desktop)를 Hugging Face Hub에 직접 연결합니다. 연결이 완료되면, 편집기, 채팅 또는 CLI 안에서 Hub 리소스를 검색하고 탐색하며 커뮤니티 도구를 사용할 수 있습니다.
실현할 수 있는 것
- Hub 리소스 검색 및 탐색: 모델, 데이터셋, Spaces, 논문 등.
- 자연어 쿼리로 Hugging Face 문서를 검색합니다.
- Jobs를 예약하고 실행하며 샌드박스를 사용하세요
- Spaces에 호스팅된 MCP 호환 Gradio 앱을 통해 커뮤니티 도구를 실행합니다.
- 메타데이터, 링크, 컨텍스트를 포함하여 결과를 어시스턴트로 가져옵니다.
시작하기
로그인 상태에서 MCP 설정을 여세요.
클라이언트 선택: MCP 호환 클라이언트(예: Cursor, VS Code, Zed, Claude Desktop)를 선택합니다. 페이지에는 클라이언트별 안내 사항과 복사해서 바로 사용할 수 있는 구성 스니펫이 표시됩니다.
붙여넣기 및 재시작: 스니펫을 클라이언트의 MCP 구성에 복사한 후 저장하고 클라이언트를 재시작/재로드합니다. 클라이언트에 “Hugging Face”(또는 유사한 이름)가 연결된 MCP 서버로 나열되어 있어야 합니다.
설정 페이지는 클라이언트가 기대하는 정확한 구성을 생성합니다. 구성을 수동으로 작성하는 대신 이 페이지를 사용하세요.
서버 사용
연결이 완료되면, 어시스턴트에게 Hugging Face 도구를 사용하도록 요청하세요. 예시 프롬프트:
- “Qwen 3.6 Quantizations의 Hugging Face 모델을 검색합니다.”
- 오디오 파일을 전사할 수 있는 Space를 찾아보세요.
- “날씨 시계열에 관한 데이터셋을 보여 줍니다.”
- “지브리 스타일의 고양이 1024 x 1024 이미지를 생성하세요.”
- 와 함께 LoRA 어댑터를 사용하는 방법은 무엇인가요? (Documentation Semantic Search 사용)
- “비전-언어 모델에 대한 논문을 찾습니다.”
Assistant는 MCP Server가 제공하는 도구(다음 섹션에 표시된 대로 선택한 Spaces 포함)를 사용하여 Hub를 탐색하고 결과를(제목, 소유자, 다운로드 수, 링크 등) 반환합니다. 이후 Hub에서 해당 리소스를 열거나 같은 채팅에서 반복 작업을 계속할 수 있습니다.
내장 도구
대부분의 Hub 작업은 내장된 hf_fs 도구로 효율적으로 수행할 수 있습니다. 이 도구를 사용하면 Documents와 Spaces의 의미론적 검색을 포함하여 Hub를 효율적으로 탐색할 수 있습니다.
MCP 설정 페이지에서 추가 도구를 구성할 수 있습니다.
| 도구 | 설명 |
|---|---|
| 컨트리뷰트 리포지토리 | 생성된 저장소에 파일을 생성하고 작성합니다 |
| 샌드박스 | 샌드박스 생성 및 사용: Sandbox 파일 관리 포함 |
| 작업 실행 및 관리 | Hugging Face 인프라에서 작업을 실행, 모니터링 및 예약합니다. |
실험적 도구가 주기적으로 추가됩니다. 해당 도구가 사용 경험을 향상시키는지 확인하고 여기에서 피드백을 남겨 주세요.
커뮤니티 도구(Spaces) 추가
커뮤니티에서 만든 MCP 호환 Gradio Spaces로 설정을 확장할 수 있습니다:
Gradio MCP 앱은 함수를 도구(인자와 설명 포함)로 노출하여 어시스턴트가 이를 직접 호출할 수 있도록 합니다. 추가한 새 도구를 인식하려면 클라이언트를 재시작하거나 새로고침해 주세요.
MCP 서버로 Spaces를 사용하는 방법에 대한 전용 가이드를 여기에서 확인해 보세요.
Spaces 옵션
MCP 설정에는 Spaces의 동작 방식을 사용자 정의할 수 있는 여러 옵션이 제공됩니다:
| 옵션 | 설명 |
|---|---|
| 동적 Spaces | 런타임에서 MCP Spaces를 동적으로 호출합니다. 활성화하면 어시스턴트가 수동으로 추가하지 않고도 MCP 호환 Spaces를 실시간으로 발견하고 사용할 수 있습니다. |
| 임베디드 이미지 제거 | Gradio Spaces에서 생성된 내장 이미지를 제거합니다. MCP 클라이언트의 이미지 지원이 제한적이거나 텍스트 전용 응답을 원할 때 유용합니다. |
자세히 알아보기
- 설정 및 클라이언트 설정: https://huggingface.co/settings/mcp
- Changelog 공지: https://huggingface.co/changelog/hf-mcp-server
- Hugging Face MCP 서버: https://huggingface.co/mcp
- Gradio Spaces로 나만의 MCP Server 만들기: https://www.gradio.app/guides/building-mcp-server-with-gradio