数据集查看服务器

一个用于与Hugging Face数据集查看API交互的MCP服务器,提供浏览和分析Hugging Face Hub上托管的数据集的能力。

  • by privetin
  • Python
  • 本地部署
  • 31 星标
  • 更新于
在 GitHub 查看 privetin/dataset-viewer

使用说明

数据集查看器MCP服务器

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

特性

资源

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

工具

服务器提供以下工具:

  1. 验证

    • 检查数据集是否存在且可访问
    • 参数:
      • dataset:数据集标识符(例如“stanfordnlp/imdb”)
      • auth_token (可选):用于私有数据集
  2. 获取信息

    • 获取数据集的详细信息
    • 参数:
      • dataset:数据集标识符
      • auth_token (可选):用于私有数据集
  3. get_rows

    • 获取数据集的分页内容
    • 参数:
      • dataset:数据集标识符
      • config:配置名称
      • split:拆分名称
      • page (可选):页码(从0开始)
      • auth_token (可选):用于私有数据集
  4. get_first_rows

    • 从数据集分割中获取第一行
    • 参数:
      • dataset:数据集标识符
      • config:配置名称
      • split:拆分名称
      • auth_token (可选):用于私有数据集
  5. get_统计

    • 获取数据集拆分的统计信息
    • 参数:
      • dataset:数据集标识符
      • config:配置名称
      • split:拆分名称
      • auth_token (可选):用于私有数据集
  6. 搜索_数据集

    • 在数据集中搜索文本
    • 参数:
      • dataset:数据集标识符
      • config:配置名称
      • split:拆分名称
      • query:要搜索的文本
      • auth_token (可选):用于私有数据集
  7. 过滤器

    • 使用类似SQL的条件筛选行
    • 参数:
      • dataset:数据集标识符
      • config:配置名称
      • split:拆分名称
      • where:SQL WHERE子句(例如“分数>0.5”)
      • orderby (可选):SQL ORDER BY子句
      • page (可选):页码(从0开始)
      • auth_token (可选):用于私有数据集
  8. 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许可证-请参阅 许可证 详见