Skip to main content
Glama
Claude MCP Data Explorer

Claude MCP Data Explorer

by tofunori

Claude MCP データエクスプローラー(Windows 用)

Claude によるデータ探索のための Model Context Protocol (MCP) サーバーの TypeScript 実装です。このサーバーは Claude Desktop と統合されており、CSV ファイルの読み込みや JavaScript データ分析スクリプトの実行ツールを提供することで、高度なデータ分析を可能にします。

前提条件

Related MCP server: mcp-csv-analyst

インストール(Windows 用に更新)

  1. このリポジトリをクローンする

    git clone https://github.com/tofunori/claude-mcp-data-explorer.git
    cd claude-mcp-data-explorer
  2. 依存関係をインストールする

    npm install
  3. セットアップスクリプトをビルドして実行する

    npm run setup

    これにより、次のようになります。

    • TypeScriptコードをJavaScriptにビルドする

    • コンパイルされたJavaScriptを使用するようにClaude Desktopを設定する

    • 必要なディレクトリを作成する

  4. Claude Desktopを再起動して開発者モードを有効にします

    • Claude Desktopを完全に閉じる

    • Claudeデスクトップを起動

    • ヘルプ→開発者モードを有効にする

手動テスト

次のコマンドを実行してサーバーを直接テストできます。

npm run build
npm run start

サーバーはエラーなく起動するはずです。正常に実行できれば、Claude Desktop でもサーバーを使用できるはずです。

仕組み

この MCP サーバーは、Claude に 2 つの主要なツールを提供します。

  1. load-csv - 分析のためにCSVデータをメモリにロードします

  2. run-script - データ処理と分析のためのJavaScriptコードを実行します

また、構造化されたデータ探索プロセスを通じて Claude をガイドするプロンプト テンプレートも含まれています。

使用法

  1. Claudeデスクトップを起動

  2. 「データの探索」プロンプトテンプレートを選択します

    • このプロンプトはセットアップ後にClaude Desktopに表示されます

  3. CSVファイルのパスと探索トピックを入力してください

    • ファイルパスの例: C:/Users/YourName/Documents/data.csv

    • トピック例:「地域別の売上動向」

  4. クロードにデータを分析してもらいましょう

    • クロードはCSVファイルを読み込み、自動的にインサイトを生成します

    • サーバーはチャンク化を使用して大きなファイルを効率的に処理します

トラブルシューティング

  1. クロードはMCPサーバーを表示しません

    • %APPDATA%\Claude\claude_desktop_config.jsonにある構成ファイルを確認します。

    • これは、distディレクトリ内のコンパイルされたJavaScriptファイルを指す必要があります。

    • npm run buildでプロジェクトを再構築してみてください

    • 開発者モードを有効にして、MCP ログファイルを確認します (開発者 → MCP ログファイルを開く)

    • 開発者 → すべてのMCPサーバーを再読み込みを使用して強制的に更新します

  2. ファイルの読み取り権限エラー

    • クロードがCSVファイルの場所にアクセスできることを確認してください

    • スラッシュ( / )またはエスケープされたバックスラッシュ( \\ )を使用した絶対パスを使用してみてください

  3. スクリプト内のJavaScriptエラー

    • スクリプトが許可されたモジュールと互換性があることを確認してください

    • クロードの回答にあるエラーメッセージを確認します

ライセンス

MIT ライセンス - 詳細については LICENSE ファイルを参照してください。

謝辞

  • Anthropicの公式MCP TypeScript SDKに基づいています

  • 例とインスピレーションを提供してくれたMCPコミュニティに感謝します

Available Tools

2 tools
load-csvC

Load a CSV file into a DataFrame for analysis

Inputs: csv_path (required), df_name.

run-scriptC

Execute a JavaScript script for data analysis and visualization

Inputs: script (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one loads CSV data into a DataFrame, while the other executes JavaScript scripts for analysis and visualization. There is no overlap or ambiguity between these functions, making it easy for an agent to select the correct tool.

    Naming Consistency4/5

    Both tools use a verb-noun pattern (load-csv, run-script), which is consistent and readable. The hyphenated style is maintained throughout, though the specific convention (hyphens vs. underscores) is less important than the consistency, which is good here with only minor deviations from common patterns.

    Tool Count2/5

    With only two tools, the server feels thin for a 'Data Explorer' purpose, as it lacks essential operations like data querying, filtering, transformation, or exporting. While the tools are functional, the count is too low to adequately cover the expected scope of data exploration and analysis.

    Completeness2/5

    For a data exploration server, there are significant gaps: no tools for querying data, filtering, aggregating, visualizing beyond scripts, or exporting results. The surface is severely incomplete, as agents cannot perform basic data exploration tasks without relying heavily on external scripts, leading to potential failures in common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      Not graded
      maintenance
      An MCP server that enables AI assistants to load, query, and analyze local CSV files using tools for filtering, aggregation, and grouping. It provides capabilities to describe schemas, calculate statistics, and sample data directly from CSV files.
      6
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A local MCP server for analyzing CSV files from your filesystem, particularly suited for chatbot conversation logs. Allows listing, reading, filtering, merging, and statistical analysis of CSV data via natural language.
      -
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server for dataset exploration and analysis, enabling LLM clients to perform summary, correlation, distribution, missing value analysis, data cleaning, and statistical tests directly on CSV files.
      3
      -