Dataset Viewer

🚀 データセットビューワー MCP サーバー

Hugging Face データセットビューワー API とやり取りするための MCP サーバーです。Hugging Face リポジトリにホストされているデータセットを閲覧および分析する機能を提供します。

✨ 主な機能

リソース

• dataset:// URI スキームを使用して Hugging Face データセットにアクセス
• データセットの設定と分割をサポート
• データセット内容のページングアクセスを提供
• プライベートデータセットの認証を処理
• データセット内容の検索とフィルタリングをサポート
• データセットの統計情報と分析を提供

ツール

このサーバーは以下のツールを提供します。

1. validate

   • データセットが存在し、アクセス可能かどうかを確認
   • パラメータ：
     • dataset：データセット識別子（例：'stanfordnlp/imdb'）
     • auth_token（オプション）：プライベートデータセット用

2. get_info

   • データセットの詳細情報を取得
   • パラメータ：
     • dataset：データセット識別子
     • auth_token（オプション）：プライベートデータセット用

3. get_rows

   • データセット内容のページングアクセスを取得
   • パラメータ：
     • dataset：データセット識別子
     • config：設定名
     • split：分割名
     • page（オプション）：ページ番号（0 から始まる）
     • auth_token（オプション）：プライベートデータセット用

4. get_first_rows

   • データセット分割の最初の数行を取得
   • パラメータ：
     • dataset：データセット識別子
     • config：設定名
     • split：分割名
     • auth_token（オプション）：プライベートデータセット用

5. get_statistics

   • データセット分割の統計情報を取得
   • パラメータ：
     • dataset：データセット識別子
     • config：設定名
     • split：分割名

6. search

   • データセット内で内容を検索
   • パラメータ：
     • dataset：データセット識別子
     • query：検索クエリ
     • auth_token（オプション）：プライベートデータセット用

7. filter

   • 条件に基づいてデータセット内容をフィルタリング
   • パラメータ：
     • dataset：データセット識別子
     • condition：フィルタリング条件
     • auth_token（オプション）：プライベートデータセット用

📦 インストール

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"
  }
}

💻 使用例

基本的な使用法

例 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 を参照してください。