Dataset Explorer

Dataset Explorer — ローカルデータ分析用 MCP サーバー

PyPI からダウンロード · 公式 MCP レジストリ · Glama ディレクトリ

お使いのコンピューターにあるデータセットについて、AI アシスタントに質問できます。 Dataset Explorer が計算を行うため、アシスタントはファイルの内容や注意が必要な点、関連する列を説明できます。

たとえば、次のように質問できます。「売上ファイルを調べてください。欠損値はありますか？重複した行はありますか？どの列が収益に関連していますか？」

元のファイルは変更されません。ホスティングするウェブサイトも、設定が必要な Gemini API キーもありません。

どのようなことに役立ちますか？

• 行数、列、平均値、中央値など、データを要約します。
• 欠損値、重複した行、異常な数値を見つけます。
• 確認したい列を詳しく調べます。
• 列を比較して、それらの関係を調べます。

対応ファイル：CSV、TSV、Excel（.xlsx と .xls）、JSON、Parquet。 Excel の場合は、最初のワークシートが使用されます。JSON ファイルには、表形式のデータを含めてください。

はじめに

1. インストールする

Python 3.10 以降が必要です。ターミナルで次を実行してください。

python -m pip install dataset-explorer-mcp

Dataset Explorer と必要なライブラリがダウンロードされます。 PyPIからも入手できます。

2. AI アシスタントに接続する

Claude Desktop、Cursor、またはCopilot を搭載した VS Codeを使用してください。これらのアプリは、MCP を通じてローカルツールに接続できます。以下から使用するアプリを選び、追加する設定を確認してください。

{
  "mcpServers": {
    "dataset-explorer": {
      "command": "python",
      "args": ["-m", "mcp_server"]
    }
  }
}

{
  "servers": {
    "dataset-explorer": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_server"]
    }
  }
}

アプリを再起動するか、MCP 設定を再読み込みしてください。Dataset Explorer が起動します。Python が見つからない場合は、以下の簡単な対処方法をご覧ください。

3. ファイルについて質問する

アシスタントにファイルのフルパスを伝え、質問してください。

Dataset Explorer を使って C:/Users/YourName/Downloads/sales.csv を要約してください。 欠損値と重複した行を確認し、結果を説明してください。

macOS または Linux では、/Users/yourname/data/sales.csv や /home/yourname/data/sales.csv のようなパスを使用してください。

ファイルは、サーバーを実行するコンピューター上にある必要があります。使用するアプリの設定に応じて、アシスタントが計算結果を AI プロバイダーに送信することがあります。

関係性はどのように調べますか？

データセットから、確立された統計量を直接計算します。

• ピアソン相関係数： 2 つの数値列がどのように連動するかを示します。
• イータ二乗： グループ間で数値がどのように異なるかを示します。
• クラメールの V： 2 つのカテゴリ列がどのように関連するかを示します。

列に適した手法が選ばれます。これらの結果はパターンの発見に役立ちますが、ある事象が別の事象を引き起こすことを証明するものではありません。結果は提供するデータによって異なります。

クイック修正

• Python またはパッケージが見つからない場合： インストールしたターミナルで python -c "import sys; print(sys.executable)" を実行してください。 表示されたパスを、アプリの設定内で python の代わりに指定してください。 Windows では、パスの区切りにスラッシュを使用してください。
• ファイルが見つからない場合： ファイルのフルパスを指定し、アシスタントに読み取り権限があることを確認してください。
• ツールが表示されない場合： MCP の設定を再読み込みし、アプリのサーバーログを確認してください。
• ターミナルがアイドル状態に見える場合： これは正常です。このサーバーはアシスタントの接続を待機しており、独自のチャットウィンドウは開きません。

大きなファイルの場合、サーバーはリクエストごとにデータセットを読み込むため、十分なメモリが必要です。

python -m pip install -e ".[dev]"
python -m pytest -q
python mcp_server.py

MIT ライセンスです。LICENSE を参照してください。