Claude MCP Data Explorer

Claude MCP データエクスプローラー（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デスクトップを起動
   • ヘルプ→開発者モードを有効にする

手動テスト

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

サーバーはエラーなく起動するはずです。正常に実行できれば、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コミュニティに感謝します