金大哥 - Dataset Viewer MCP 详情

article

README

🚀 数据集查看器 MCP 服务器

本项目是一个用于与 Hugging Face 数据集查看器 API 交互的 MCP 服务器，能够提供浏览和分析在 Hugging Face 存储库上托管的数据集的功能，助力用户高效处理各类数据集。

🚀 快速开始

安装步骤

使用 Git 克隆仓库

git clone https://github.com/your-organization/dataset-viewer-mcp.git
cd dataset-viewer-mcp

安装依赖项

npm install

启动服务器

node index.js

配置环境变量

设置 Hugging Face API 令牌

设置以下环境变量以访问 Hugging Face 的 API：

export HUGGING_FACE_TOKEN=your_api_token_here

在 Windows 上配置

在 Windows 系统中，您可以使用以下命令设置环境变量：

set HUGGING_FACE_TOKEN=your_api_token_here

配置示例 - Claude Desktop

要在 Claude Desktop 上配置，请将以下内容添加到相应的配置文件中：

{
  "datasetViewerMcp": {
    "path": "%应用程序数据%/claude-desktop/dataset-viewer-mcp",
    "configPath": "~/.config/claude/dataset-viewer-mcp.json"
  }
}

✨ 主要特性

资源

使用 dataset:// URI 方案访问 Hugging Face 数据集。
支持数据集配置和分块，满足多样化的数据处理需求。
提供分页访问数据集内容，方便用户按需查看。
处理私有数据集的身份验证，保障数据安全。
支持搜索和过滤数据集内容，提升数据检索效率。
提供数据集统计信息和分析，助力用户深入了解数据。

工具

该服务器提供以下实用工具：

validate
- 功能：检查数据集是否存在且可访问。
- 参数：
  - dataset：数据集标识符（例如 'stanfordnlp/imdb'）。
  - auth_token（可选）：用于私有数据集。
get_info
- 功能：获取数据集的详细信息。
- 参数：
  - dataset：数据集标识符。
  - auth_token（可选）：用于私有数据集。
get_rows
- 功能：获取数据集内容的分页访问。
- 参数：
  - dataset：数据集标识符。
  - config：配置名称。
  - split：分块名称。
  - page（可选）：页码（从 0 开始）。
  - auth_token（可选）：用于私有数据集。
get_first_rows
- 功能：获取数据集分块的前几行。
- 参数：
  - dataset：数据集标识符。
  - config：配置名称。
  - split：分块名称。
  - auth_token（可选）：用于私有数据集。
get_statistics
- 功能：获取数据集分块的统计信息。
- 参数：
  - dataset：数据集标识符。
  - config：配置名称。
  - split：分块名称。
search
- 功能：在数据集中搜索内容。
- 参数：
  - dataset：数据集标识符。
  - query：搜索查询。
  - auth_token（可选）：用于私有数据集。
filter
- 功能：根据条件过滤数据集内容。
- 参数：
  - dataset：数据集标识符。
  - condition：过滤条件。
  - auth_token（可选）：用于私有数据集。

💻 使用示例

基础用法

示例 1：验证数据集存在性

{
  "dataset": "stanfordnlp/imdb",
  "auth_token": "your_api_token_here"
}

示例 2：获取数据集信息

{
  "dataset": "stanfordnlp/imdb",
  "auth_token": "your_api_token_here"
}

示例 3：获取分页内容

{
  "dataset": "stanfordnlp/imdb",
  "config": "default",
  "split": "train",
  "page": 0,
  "auth_token": "your_api_token_here"
}

示例 4：搜索数据集内容

{
  "dataset": "stanfordnlp/imdb",
  "query": "电影评论",
  "auth_token": "your_api_token_here"
}

📄 许可证

本项目采用 MIT License，详情请参阅 LICENSE。

Dataset Viewer