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

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

前提条件

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

• Claude Desktop - Claude Desktop をダウンロード

Related MCP server: Cancellation Analyzer MCP Server

インストール（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コミュニティに感謝します