🤗 껴안는 얼굴 MCP 서버 🤗

Hugging Face Hub API에 대한 읽기 전용 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 Claude와 같은 LLM은 Hugging Face의 모델, 데이터세트, 공간, 논문 및 컬렉션과 상호 작용할 수 있습니다.

구성 요소

자원

이 서버는 인기 있는 Hugging Face 리소스를 제공합니다.

• 리소스에 액세스하기 위한 사용자 지정 hf:// URI 체계
• hf://model/{model_id} URI가 있는 모델
• hf://dataset/{dataset_id} URI가 있는 데이터 세트
• hf://space/{space_id} URI가 있는 공간
• 모든 리소스에는 설명적 이름과 JSON 콘텐츠 유형이 있습니다.

프롬프트

서버는 두 가지 프롬프트 템플릿을 제공합니다.

• compare-models : 여러 개의 Hugging Face 모델 간의 비교를 생성합니다.
  • 필수 model_ids 인수(쉼표로 구분된 모델 ID)
  • 모델 세부 정보를 검색하고 비교를 위해 형식을 지정합니다.
• summarize-paper : Hugging Face의 연구 논문을 요약합니다.
  • 논문 식별을 위한 필수 arxiv_id 인수
  • 요약 깊이를 제어하기 위한 선택적 detail_level 인수(brief/detailed)
  • 구현 세부 정보와 종이 메타데이터를 결합합니다.

도구

서버는 여러 도구 범주를 구현합니다.

• 모델 도구
  • search-models : 쿼리, 작성자, 태그 및 제한에 대한 필터를 사용하여 모델 검색
  • get-model-info : 특정 모델에 대한 자세한 정보를 가져옵니다.
• 데이터 세트 도구
  • search-datasets : 필터를 사용하여 데이터세트 검색
  • get-dataset-info : 특정 데이터 세트에 대한 자세한 정보를 가져옵니다.
• 우주 도구
  • search-spaces : SDK 유형을 포함한 필터가 있는 검색 공간
  • get-space-info : 특정 공간에 대한 자세한 정보를 가져옵니다.
• 종이 도구
  • get-paper-info : 논문 및 구현에 대한 정보를 가져옵니다.
  • get-daily-papers : 큐레이팅된 일간지 목록을 받아보세요
• 수집 도구
  • search-collections : 다양한 필터로 컬렉션 검색
  • get-collection-info : 특정 컬렉션에 대한 자세한 정보를 가져옵니다.

구성

서버에는 구성이 필요하지 않지만 선택적인 Hugging Face 인증을 지원합니다.

• Hugging Face API 토큰을 사용하여 HF_TOKEN 환경 변수를 설정하세요.
  • 더 높은 API 속도 제한
  • 개인 저장소에 대한 액세스(권한이 있는 경우)
  • 대량 요청에 대한 안정성 향상

빠른 시작

설치하다

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 huggingface-mcp-server를 자동으로 설치하려면:

지엑스피1

클로드 데스크탑

MacOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

개발

건축 및 출판

배포를 위해 패키지를 준비하려면:

1. 종속성 동기화 및 잠금 파일 업데이트:

1. 패키지 배포 빌드:

이렇게 하면 dist/ 디렉토리에 소스와 휠 배포판이 생성됩니다.

1. PyPI에 게시:

참고: 환경 변수나 명령 플래그를 통해 PyPI 자격 증명을 설정해야 합니다.

• 토큰: --token 또는 UV_PUBLISH_TOKEN
• 또는 사용자 이름/비밀번호: --username / UV_PUBLISH_USERNAME 및 --password / UV_PUBLISH_PASSWORD

디버깅

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.

클로드에 대한 예시 프롬프트

Claude와 함께 이 서버를 사용할 때 다음 예시 프롬프트를 시도해 보세요.

• "1억개 미만의 매개변수를 갖는 Hugging Face의 BERT 모델 검색"
• "Hugging Face에 대한 텍스트 분류를 위한 가장 인기 있는 데이터 세트를 찾으세요"
• "오늘의 Hugging Face에 대한 AI 연구 논문은 무엇인가요?"
• "Hugging Face MCP 서버를 사용하여 arXiv ID 2307.09288의 논문을 요약하세요."
• "Hugging Face의 Llama-3-8B와 Mistral-7B 모델을 비교해 보세요"
• "이미지 생성을 위한 가장 인기 있는 Gradio 공간을 보여주세요"
• "Mixtral 모델을 포함하는 TheBloke가 만든 컬렉션을 찾아보세요"

문제 해결

서버에 문제가 발생하는 경우:

1. Claude Desktop에서 서버 로그를 확인하세요.
   • macOS: ~/Library/Logs/Claude/mcp-server-huggingface.log
   • Windows: %APPDATA%\Claude\logs\mcp-server-huggingface.log
2. API 속도 제한 오류의 경우 Hugging Face API 토큰을 추가하는 것을 고려하세요.
3. Hugging Face API에 접속하려면 기기에 인터넷 연결이 있는지 확인하세요.
4. 특정 도구가 실패하는 경우 Hugging Face 웹사이트를 통해 동일한 데이터에 액세스하여 해당 도구가 존재하는지 확인해 보세요.