Dataset Viewer MCP Server

Dataset Viewer MCP サーバー

Hugging Face Dataset Viewer API と連携するための MCP サーバーです。Hugging Face Hub でホストされているデータセットを閲覧・分析する機能を提供します。

機能

リソース

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

ツール

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

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: 分割名
     • auth_token (任意): プライベートデータセット用

6. search_dataset

   • データセット内のテキストを検索します
   • パラメータ:
     • dataset: データセット識別子
     • config: 設定名
     • split: 分割名
     • query: 検索するテキスト
     • auth_token (任意): プライベートデータセット用

7. filter

   • SQL ライクな条件を使用して行をフィルタリングします
   • パラメータ:
     • dataset: データセット識別子
     • config: 設定名
     • split: 分割名
     • where: SQL WHERE 句 (例: "score > 0.5")
     • orderby (任意): SQL ORDER BY 句
     • page (任意): ページ番号 (0 始まり)
     • auth_token (任意): プライベートデータセット用

8. get_parquet

   • データセット全体を Parquet 形式でダウンロードします
   • パラメータ:
     • dataset: データセット識別子
     • auth_token (任意): プライベートデータセット用

インストール

前提条件

• Python 3.12 以降
• uv - 高速な Python パッケージインストーラー兼リゾルバー

セットアップ

1. リポジトリをクローンします:

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

2. 仮想環境を作成してインストールします:

# 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: プライベートデータセットにアクセスするための Hugging Face API トークン

Claude Desktop との統合

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 ライセンス - 詳細は LICENSE を参照してください