Data Explorer

🚀 Claude MCP データエクスプローラー（Windows用）

このプロジェクトは、TypeScript で実装されたモデルコンテキストプロトコル（MCP）サーバーです。Claude と統合してデータエクスプローレーションを行うことができます。このサーバーは、CSV ファイルの読み込みと JavaScript データ分析スクリプトの実行をサポートし、高度なデータ分析を可能にします。

🚀 クイックスタート

✨ 前提条件

• Node.js v16+ - Node.jsをダウンロード
• Claude デスクトップアプリケーション - Claude デスクトップをダウンロード

📦 インストール（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 にコンパイル
• Claude デスクトップアプリケーションがコンパイルされた JavaScript を使用するように設定
• 必要なディレクトリを作成

4. Claude デスクトップアプリケーションを閉じて再起動し、開発者モードを有効にする

• Claude デスクトップアプリケーションを完全に閉じる
• Claude デスクトップアプリケーションを起動する
• ヘルプメニュー → 開発者モードを有効にする

💻 使用例

基本的な使用法

あなたは以下のコマンドを実行することで、サーバーを直接テストすることができます：

npm run build
npm run start

サーバーがエラーなく起動した場合、Claude デスクトップアプリケーションはこのサーバーを使用できます。

📚 ドキュメント

動作原理

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

1. load-csv - CSV データをメモリにロードして分析する
2. run-script - JavaScript コードを実行してデータを処理および分析する また、Claude が構造化されたデータ分析プロセスを行うためのプロンプトテンプレートも含まれています。

使用方法

1. Claude デスクトップアプリケーションを起動する
2. 「データを探索する」プロンプトテンプレートを選択する
   • インストールが完了すると、このプロンプトが Claude デスクトップアプリケーションに表示されます
3. CSV ファイルのパスと分析テーマを入力する
   • サンプルファイルパス：C:/Users/YourName/Documents/data.csv
   • サンプルテーマ：「地域別の販売傾向」
4. Claude にデータ分析を行わせる
   • Claude は自動的に CSV ファイルをロードし、洞察を生成します
   • サーバーは大きなファイルをチャンクで処理することで、効率的な動作を確保します

🔧 トラブルシューティング

1. Claude が MCP サーバーを表示しない場合
   • 設定ファイルを確認：%APPDATA%\Claude\claude_desktop_config.json
   • それが dist ディレクトリ内のコンパイルされた JavaScript ファイルを指していることを確認
   • npm run build を使用してプロジェクトを再構築してみる
   • 開発者モードを有効にした後、MCP ログファイルを確認（開発者 → MCP ログファイルを開く）
   • 「すべての MCP サーバーを再読み込み」を使用して強制的に更新する
2. ファイルの読み取り時に権限エラーが発生する場合
   • Claude が CSV ファイルのパスにアクセスできることを確認
   • スラッシュ (/) またはエスケープされたバックスラッシュ (\\) を含む絶対パスを使用してみる
3. JavaScript スクリプトにエラーがある場合
   • スクリプトが許可されたモジュールと互換性があることを確認
   • Claude の応答に含まれるエラー情報を確認

📄 ライセンス

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

謝辞

• Anthropic の公式 MCP TypeScript SDK に基づいています
• MCP コミュニティのサンプルと啓発に感謝します