Claude MCP Data Explorer for Windows

Claude MCP Data Explorer for Windows

Claude を使ったデータ探索用の Model Context Protocol（MCP）サーバーを TypeScript で実装したものです。このサーバーは Claude Desktop と連携し、CSV ファイルの読み込みや JavaScript によるデータ分析スクリプトの実行ツールを提供して、高度なデータ分析を可能にします。

前提条件

• Node.js v16+ - Node.js をダウンロード
• Claude Desktop - Claude Desktop をダウンロード

インストール（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 Desktop を起動します
   • ヘルプ → 開発者モードを有効にする に移動します

手動テスト

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

npm run build
npm run start

サーバーはエラーなしで起動するはずです。このコマンドが正常に実行できれば、Claude Desktop でもサーバーを使用できます。

仕組み

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

1. load-csv - 分析用に CSV データをメモリに読み込みます
2. run-script - データ処理と分析のために JavaScript コードを実行します

また、構造化されたデータ探索プロセスを Claude に案内するプロンプトテンプレートも含まれています。

使い方

1. Claude Desktop を起動します

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

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

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 - 詳細については LICENSE ファイルを参照してください。

謝辞

• Anthropic の公式 MCP TypeScript SDK を基にしています
• 事例や着想を提供してくれた MCP コミュニティに感謝します