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

2. get_info

3. get_rows

4. get_first_rows

5. get_statistics

6. search_dataset

7. filter

8. get_parquet

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:
.venv\Scripts\activate

# Install in development mode
uv add -e .

Configuration

Environment Variables

• `HUGGINGFACE_TOKEN`: Your Hugging Face API token for accessing private datasets

Claude Desktop Integration

Add the following to your Claude Desktop config file:

On Windows: `%APPDATA%\Claude\claude_desktop_config.json`

On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "dataset-viewer": {
      "command": "uv",
      "args": [
        "--directory",
        "parent_to_repo/dataset-viewer",
        "run",
        "dataset-viewer"
      ]
    }
  }
}

License

MIT License - see LICENSE for details