claudekit / tools / huggingface
[ MCP · Data Engineering ]

Hugging Face

Hugging Face가 직접 호스팅하는 공식 원격 MCP 서버. Claude Code에서 모델, 데이터셋, Spaces, 논문, 문서를 자연어로 검색하고 Gradio Space 도구를 호출합니다.

huggingface/hf-mcp-server ·updated
$ claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login copy

Hugging Face가 직접 호스팅하는 공식 원격 MCP 서버(huggingface/hf-mcp-server).

왜 필요한가?

작업에 맞는 모델이나 데이터셋을 찾으려면 Hugging Face Hub를 따로 검색해야 했습니다. Hugging Face MCP를 연결하면 Claude Code에서 모델, 데이터셋, Spaces, 논문, 문서를 자연어로 검색하고, Gradio Space 기반 도구까지 호출할 수 있습니다.

무엇을 할 수 있나

Hugging Face 공식 문서가 안내하는 대표 작업입니다.

  • 모델 검색 — “Qwen 3 Quantizations 모델을 찾아줘”
  • 데이터셋 검색 — “날씨 시계열 데이터셋을 보여줘”
  • Space 검색 — “오디오를 전사할 수 있는 Space를 찾아줘”
  • 이미지 생성 — “고양이를 지브리 스타일로 1024 x 1024 이미지로 만들어줘” (Gradio Space 도구)
  • 문서 검색 — “PEFT로 LoRA 어댑터를 쓰는 방법은?”
  • 논문 검색 — “vision-language 모델 관련 논문을 찾아줘”

근거: huggingface.co/docs/hub/en/hf-mcp-server, huggingface.co/blog/claude-and-mcp.

핵심 기능

  • 검색 — 모델, 데이터셋, Spaces, 논문, 문서 시맨틱 검색
  • Hub 상세 — 모델, 데이터셋, Spaces 상세 정보(README 포함 옵션)
  • Jobs — HF 인프라에서 작업 실행, 모니터링, 예약
  • Gradio Space 도구 — 이미지 생성, 오디오 전사 등 MCP 호환 Space를 도구로 추가

연결 방법

브라우저 로그인:

claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login

토큰 헤더:

claude mcp add hf-mcp-server -t http https://huggingface.co/mcp -H "Authorization: Bearer YOUR_HF_TOKEN"

사용할 도구는 huggingface.co/settings/mcp에서 켜고 끌 수 있습니다.

알아두면 좋은 점

  • 인증 — HF 액세스 토큰(huggingface.co/settings/tokens)을 ?login 흐름 또는 Authorization 헤더로 전달
  • 라이선스 — MIT(huggingface/hf-mcp-server)
  • 이미지 생성 등 Gradio Space 도구를 쓰려면 Claude에서 커스텀 커넥터로 추가(원격 MCP URL https://huggingface.co/mcp?login)
  • 로컬 stdio 모드도 지원
§ 6

See also

same category · curated
[01]
[Skill] Last30Days · `/last30days <주제>` 한 번으로 Reddit, X, YouTube, Hacker News, Polymarket, 웹을 가로질러 최근 30일을 리서치하고 인용된 brief로 종합하는 스킬. 편집 권위가 아니라 실제 참여 지표(업보트, 좋아요, 조회수, 예측시장 배당률)로 결과를 스코어링하고, 관련 핸들, 서브레딧, GitHub 리포를 먼저 찾은 뒤 병렬로 조회해 플랫폼 간 중복 스토리를 병합합니다. Reddit, HN, Polymarket, GitHub은 API 키 없이 즉시 동작합니다.
tool · claudekit.io / tools / last30days
[02]
[Tool] Firecrawl · 🔥 The API to search, scrape, and interact with the web for AI. Search·Scrape·Interact 세 가지 기능을 한 API 로 통합 제공하는 오픈소스 웹 데이터 인프라. firecrawl.dev 클라우드 SaaS 의 기반이 되는 엔진으로, AGPL-3.0 으로 공개되어 docker-compose 로 self-host 가능합니다.
tool · claudekit.io / tools / firecrawl
[03]
[MCP] Firecrawl MCP · Firecrawl 이 직접 운영하는 공식 MCP 서버. 단일 URL 스크래핑·일괄 처리·사이트 크롤·웹 검색·LLM 기반 구조화 추출·자율 리서치 에이전트·인터랙티브 페이지 자동화까지 12 개 이상 도구를 제공해 Claude 에 실시간 웹 데이터와 LLM 준비된 markdown 을 공급합니다.
tool · claudekit.io / tools / firecrawl-mcp
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
Hugging Face MCP는 무엇인가요?
Hugging Face가 직접 호스팅하는 공식 원격 MCP 서버입니다(`huggingface/hf-mcp-server`). Claude Code에서 모델, 데이터셋, Spaces, 논문, 문서를 자연어로 검색하고 Gradio Space 기반 도구를 호출할 수 있습니다.
§ 7.2
어떤 환경에서 동작하나요?
Claude Code와 Claude Desktop에서 동작합니다. 원격 호스팅(`https://huggingface.co/mcp`)이라 로컬 서버 실행이 필요 없습니다.
§ 7.3
어떻게 설치하나요?
`claude mcp add hf-mcp-server -t http https://huggingface.co/mcp?login`으로 추가하면 브라우저 로그인이 진행됩니다. 또는 `-H "Authorization: Bearer YOUR_HF_TOKEN"`로 HF 액세스 토큰을 헤더로 전달합니다.
§ 7.4
어떤 작업을 할 수 있나요?
모델, 데이터셋, Spaces 검색, 논문, 문서 검색, 이미지 생성 같은 Gradio Space 도구 호출이 가능합니다. 예: "오디오를 전사할 수 있는 Space를 찾아줘".
§ 7.5
라이선스와 인증은 어떻게 되나요?
서버 코드는 MIT로 공개되어 있습니다. 인증은 huggingface.co/settings/tokens에서 발급한 HF 액세스 토큰을 사용하며, `?login` 흐름 또는 Authorization 헤더로 전달합니다.