Hugging Face Dataset Viewer API와 상호 작용하는 MCP 서버는 Hugging Face Hub에서 호스팅되는 데이터셋을 검색하고 분석하는 기능을 제공합니다.

특징

자원

• 사용 dataset:// URI 방식에 액세스하는 Hugging Face datasets
• dataset 구성 및 분할 지원
• dataset 내용에 대한 paginated Access 제공
• 개인 데이터셋을 위한 핸들 인증
• dataset 내용 검색 및 필터링 지원
• dataset 통계 및 분석 제공

도구

서버는 다음과 같은 도구를 제공합니다:

1. ** 유효성**

• dataset가 존재하는지 확인하고 접근 가능
• 모수:
• dataset: Dataset 식별자(예: ‘stanfordnlp/imdb’)
• (선택) [T2]]: 개인 데이터셋

다운로드

• dataset에 대한 자세한 정보 얻기
• 모수:
• dataset: Dataset 식별자
• (선택) [T4]]: 개인 데이터셋

3. **get rows **

• dataset의 질화된 내용을 얻으십시오
• 모수:
• dataset: Dataset 식별자
• config: 구성 이름
• [T7]]: 분할 이름
• page (선택 사항) : 페이지 번호 (0 기반)
• (선택) [T9]]: 개인 데이터셋

4. **get first rows **

• dataset 분할에서 첫 번째 행을 가져옵니다

Dataset Viewer MCP Server

An MCP server for interacting with the Hugging Face Dataset Viewer API, providing capabilities to browse and analyze datasets hosted on the Hugging Face Hub.

Features

Resources

• Uses dataset:// URI scheme for accessing Hugging Face datasets
• Supports dataset configurations and splits
• Provides paginated access to dataset contents
• Handles authentication for private datasets
• Supports searching and filtering dataset contents
• Provides dataset statistics and analysis

Tools

The server provides the following tools:

1. validate

   • Check if a dataset exists and is accessible
   • Parameters:
     • dataset: Dataset identifier (e.g. ‘stanfordnlp/imdb’)
     • auth_token (optional): For private datasets

2. get_info

   • Get detailed information about a dataset
   • Parameters:
     • dataset: Dataset identifier
     • auth_token (optional): For private datasets

3. get_rows

   • Get paginated contents of a dataset
   • Parameters:
     • dataset: Dataset identifier
     • config: Configuration name
     • split: Split name
     • page (optional): Page number (0-based)
     • auth_token (optional): For private datasets

4. get_first_rows

   • Get first rows from a dataset split
   • Parameters:
     • dataset: Dataset identifier
     • config: Configuration name
     • split: Split name
     • auth_token (optional): For private datasets

5. get_statistics

   • Get statistics about a dataset split
   • Parameters:
     • dataset: Dataset identifier
     • config: Configuration name
     • split: Split name
     • auth_token (optional): For private datasets

6. search_dataset

   • Search for text within a dataset
   • Parameters:
     • dataset: Dataset identifier
     • config: Configuration name
     • split: Split name
     • query: Text to search for
     • auth_token (optional): For private datasets

7. filter

   • Filter rows using SQL-like conditions
   • Parameters:
     • dataset: Dataset identifier
     • config: Configuration name
     • split: Split name
     • where: SQL WHERE clause (e.g. “score > 0.5”)
     • orderby (optional): SQL ORDER BY clause
     • page (optional): Page number (0-based)
     • auth_token (optional): For private datasets

8. get_parquet

   • Download entire dataset in Parquet format
   • Parameters:
     • dataset: Dataset identifier
     • auth_token (optional): For private datasets

Installation

Prerequisites

• Python 3.12 or higher
• uv - Fast Python package installer and resolver

Setup

1. Clone the repository:

git clone https://github.com/privetin/dataset-viewer.git
cd dataset-viewer

2. Create a virtual environment and install:

# Create virtual environment
uv venv

# Activate virtual environment
# On Unix:
source .venv/bin/activate
# On Windows: