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: Linear MCP Server

インストール（Windows 用に更新）

このリポジトリをクローンする
git clone https://github.com/tofunori/claude-mcp-data-explorer.git cd claude-mcp-data-explorer
依存関係をインストールする
npm install
セットアップスクリプトをビルドして実行する
npm run setup
これにより、次のようになります。
- TypeScriptコードをJavaScriptにビルドする
- コンパイルされたJavaScriptを使用するようにClaude Desktopを設定する
- 必要なディレクトリを作成する
Claude Desktopを再起動して開発者モードを有効にします
- Claude Desktopを完全に閉じる
- Claudeデスクトップを起動
- ヘルプ→開発者モードを有効にする

手動テスト

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

npm run build npm run start

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

仕組み

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

load-csv - 分析のためにCSVデータをメモリにロードします
run-script - データ処理と分析のためのJavaScriptコードを実行します

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

使用法

Claudeデスクトップを起動
「データの探索」プロンプトテンプレートを選択します
- このプロンプトはセットアップ後にClaude Desktopに表示されます
CSVファイルのパスと探索トピックを入力してください
- ファイルパスの例: C:/Users/YourName/Documents/data.csv
- トピック例:「地域別の売上動向」
クロードにデータを分析してもらいましょう
- クロードはCSVファイルを読み込み、自動的にインサイトを生成します
- サーバーはチャンク化を使用して大きなファイルを効率的に処理します

トラブルシューティング

クロードはMCPサーバーを表示しません
- %APPDATA%\Claude\claude_desktop_config.jsonにある構成ファイルを確認します。
- これは、distディレクトリ内のコンパイルされたJavaScriptファイルを指す必要があります。
- npm run buildでプロジェクトを再構築してみてください
- 開発者モードを有効にして、MCP ログファイルを確認します (開発者 → MCP ログファイルを開く)
- 開発者 → すべてのMCPサーバーを再読み込みを使用して強制的に更新します
ファイルの読み取り権限エラー
- クロードがCSVファイルの場所にアクセスできることを確認してください
- スラッシュ（ / ）またはエスケープされたバックスラッシュ（ \\ ）を使用した絶対パスを使用してみてください
スクリプト内のJavaScriptエラー
- スクリプトが許可されたモジュールと互換性があることを確認してください
- クロードの回答にあるエラーメッセージを確認します