Dataset Viewer MCP

数据集查看器MCP服务器

MCP服务器，用于与 拥抱面部数据集查看器API，提供浏览和分析Hugging Face Hub上托管的数据集的功能。

特性

资源

• 用途 dataset:// 用于访问Hugging Face数据集的URI方案
• 支持数据集配置和拆分
• 提供对数据集内容的分页访问
• 处理私有数据集的身份验证
• 支持搜索和过滤数据集内容
• 提供数据集统计和分析

工具

服务器提供以下工具：

1. 验证

- 检查数据集是否存在且可访问 - 参数： - dataset：数据集标识符（例如“stanfordnlp/imdb”） - auth_token （可选）：用于私有数据集

1. 获取信息

- 获取数据集的详细信息 - 参数： - dataset：数据集标识符 - auth_token （可选）：用于私有数据集

1. get_rows

- 获取数据集的分页内容 - 参数： - dataset：数据集标识符 - config：配置名称 - split：拆分名称 - page （可选）：页码（从0开始） - auth_token （可选）：用于私有数据集

1. get_first_rows

- 从数据集分割中获取第一行 - 参数： - dataset：数据集标识符 - config：配置名称 - split：拆分名称 - auth_token （可选）：用于私有数据集

1. get_统计

- 获取数据集拆分的统计信息 - 参数： - dataset：数据集标识符 - config：配置名称 - split：拆分名称 - auth_token （可选）：用于私有数据集

1. 搜索_数据集

- 在数据集中搜索文本 - 参数： - dataset：数据集标识符 - config：配置名称 - split：拆分名称 - query：要搜索的文本 - auth_token （可选）：用于私有数据集

1. 过滤器

- 使用类似SQL的条件筛选行 - 参数： - dataset：数据集标识符 - config：配置名称 - split：拆分名称 - where：SQL WHERE子句（例如“分数>0.5”） - orderby （可选）：SQL ORDER BY子句 - page （可选）：页码（从0开始） - auth_token （可选）：用于私有数据集

1. get_parquet

- 以Parquet格式下载整个数据集 - 参数： - dataset：数据集标识符 - auth_token （可选）：用于私有数据集

安装

先决条件

• Python 3.12或更高版本
• 紫外线 -快速Python包安装程序和解析器

设置

1. 克隆存储库：

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

1. 创建虚拟环境并安装：

# 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 .

配置

环境变量

• HUGGINGFACE_TOKEN：用于访问私人数据集的拥抱脸API令牌

Claude桌面集成

将以下内容添加到您的Claude Desktop配置文件中：

在Windows上： %APPDATA%\Claude\claude_desktop_config.json

在MacOS上： ~/Library/Application Support/Claude/claude_desktop_config.json

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

许可证

MIT许可证-请参阅 许可证 详见