MCP Server for Data Exploration

データ探索用 MCP サーバー

MCP サーバーは、インタラクティブなデータ探索のために設計された多用途なツールです。

複雑なデータセットを明確で実用的なインサイトに変える、あなた専用のデータサイエンティストアシスタントです。

🚀 試してみる

1. Claude Desktop をダウンロード

   • こちらから入手できます。

2. インストールしてセットアップ

   • macOS では、ターミナルで次のコマンドを実行します。

   python setup.py
   

3. テンプレートとツールを読み込む

   • サーバーが起動したら、Claude Desktop でプロンプトテンプレートとツールが読み込まれるまで待ちます。

4. 探索を開始

   • MCP から explore-data プロンプトテンプレートを選択します。
   • 必要な入力を指定して、会話を開始します。
     • csv_path：CSV ファイルのローカルパス
     • topic：探索するトピック（例：「ニューヨークの気象パターン」や「カリフォルニアの住宅価格」）

例

以下は、人の介入なしで MCP サーバーを使ってデータを探索する方法の例です。

ケース 1：カリフォルニアの不動産掲載価格

• Kaggle データセット：米国不動産データセット
• サイズ：2,226,382 件（178.9 MB）
• トピック：カリフォルニアの住宅価格の推移

• データ探索の概要

ケース 2：ロンドンの天気

• Kaggle データセット：英国の200万件超の日次気象履歴
• サイズ：2,836,186 件（169.3 MB）
• トピック：ロンドンの天気
• レポート：レポートを見る
• グラフ：

  • ロンドンの気温の推移

    

  • 季節ごとの気温と湿度の関係

    

  • 季節ごとの風向パターン

    

📦 コンポーネント

プロンプト

• explore-data：データ探索タスクに特化しています。

ツール

1. load-csv

   • 機能：CSV ファイルを DataFrame に読み込みます。
   • 引数：
     • csv_path（string、必須）：CSV ファイルのパス
     • df_name（string、任意）：DataFrame の名前。指定しない場合は df_1、df_2 などがデフォルトで割り当てられます。

2. run-script

   • 機能：Python スクリプトを実行します。
   • 引数：
     • script（string、必須）：実行するスクリプト

⚙️ サーバーの変更

Claude Desktop の設定

• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

開発（未公開サーバー）

"mcpServers": {
  "mcp-server-ds": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/username/src/mcp-server-ds",
      "run",
      "mcp-server-ds"
    ]
  }
}

公開済みサーバー

"mcpServers": {
  "mcp-server-ds": {
    "command": "uvx",
    "args": [
      "mcp-server-ds"
    ]
  }
}

🛠️ 開発

ビルドと公開

1. 依存関係を同期

   uv sync
   

2. 配布物をビルド

   uv build
   

   dist/ ディレクトリにソース配布物と wheel 配布物を生成します。

3. PyPI に公開

   uv publish
   

🤝 貢献

貢献を歓迎します！バグの修正、機能の追加、ドキュメントの改善など、皆さまの協力によってこのプロジェクトはより良いものになります。

問題の報告

バグを見つけた場合や提案がある場合は、issue セクションで issue を作成してください。以下を含めてください：

• 再現手順（該当する場合）
• 期待される動作と実際の動作
• スクリーンショットまたはエラーログ（関連する場合）

📜 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。 詳細については、LICENSE ファイルをご覧ください。

💬 お問い合わせ

質問やフィードバックがありますか？issue を作成するか、メンテナーにお問い合わせください。一緒にこのプロジェクトを素晴らしいものにしましょう！

概要

これは ReadingPlus.AI LLC が運営するオープンソースプロジェクトで、コミュニティ全体からの貢献を歓迎しています。