使用说明
数据集查看器MCP服务器
MCP服务器,用于与 拥抱面部数据集查看器API,提供浏览和分析Hugging Face Hub上托管的数据集的功能。
特性
资源
- 用途
dataset://用于访问Hugging Face数据集的URI方案 - 支持数据集配置和拆分
- 提供对数据集内容的分页访问
- 处理私有数据集的身份验证
- 支持搜索和过滤数据集内容
- 提供数据集统计和分析
工具
服务器提供以下工具:
-
验证
- 检查数据集是否存在且可访问
- 参数:
dataset:数据集标识符(例如“stanfordnlp/imdb”)auth_token(可选):用于私有数据集
-
获取信息
- 获取数据集的详细信息
- 参数:
dataset:数据集标识符auth_token(可选):用于私有数据集
-
get_rows
- 获取数据集的分页内容
- 参数:
dataset:数据集标识符config:配置名称split:拆分名称page(可选):页码(从0开始)auth_token(可选):用于私有数据集
-
get_first_rows
- 从数据集分割中获取第一行
- 参数:
dataset:数据集标识符config:配置名称split:拆分名称auth_token(可选):用于私有数据集
-
get_统计
- 获取数据集拆分的统计信息
- 参数:
dataset:数据集标识符config:配置名称split:拆分名称auth_token(可选):用于私有数据集
-
搜索_数据集
- 在数据集中搜索文本
- 参数:
dataset:数据集标识符config:配置名称split:拆分名称query:要搜索的文本auth_token(可选):用于私有数据集
-
过滤器
- 使用类似SQL的条件筛选行
- 参数:
dataset:数据集标识符config:配置名称split:拆分名称where:SQL WHERE子句(例如“分数>0.5”)orderby(可选):SQL ORDER BY子句page(可选):页码(从0开始)auth_token(可选):用于私有数据集
-
get_parquet
- 以Parquet格式下载整个数据集
- 参数:
dataset:数据集标识符auth_token(可选):用于私有数据集
安装
先决条件
- Python 3.12或更高版本
- 紫外线 -快速Python包安装程序和解析器
设置
- 克隆存储库:
git clone https://github.com/privetin/dataset-viewer.git
cd dataset-viewer
- 创建虚拟环境并安装:
# 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许可证-请参阅 许可证 详见