Vibe Data Analysis

🚀 Vibe 前処理と分析 MCP サーバー（CSV ファイル向け）

この強力な MCP（モデル制御プロトコル）サーバーは、CSV ファイルの前処理と分析に特化して設計されています。直感的なインターフェースを通じて、データの操作、可視化、分析を行う一連のツールを提供します。

🚀 クイックスタート

このサーバーを使用することで、CSV ファイルの前処理や分析を簡単に行うことができます。以下の手順に従ってサーバーをセットアップし、使用を開始しましょう。

✨ 主な機能

データの読み込みと管理

• 指定された作業ディレクトリから CSV ファイルを読み込む
• 作業ディレクトリを設定し、管理する
• 作業ディレクトリ内のファイルを一覧表示する
• 処理済みのデータフレームを新しいファイルに保存する

データの前処理

• 混合データ型の列を処理する
• さまざまな戦略を使用して欠損値を管理する：
  • 欠損値を含む行を削除する
  • 平均値/中央値/最頻値で埋める
  • 前方/後方補間
  • 定数で埋める
• 列を削除し、名前を変更する
• カスタムデータフレーム編集コードを実行する
• 処理済みのデータを新しいファイルに保存する

データ分析

• 包括的なデータ記述を生成する
• 相関行列を作成し、可視化する
• 混合データ型の列を処理する
• カスタム分析コードを実行する

データ可視化

• さまざまなグラフを作成する：
  • 折れ線グラフ
  • 棒グラフ
  • 散布図
  • ヒストグラム（KDE付き）
  • 箱ひげ図
  • バイオリンプロット
  • 円グラフ
  • カウントプロット
  • カーネル密度推定図
• コードでカスタムグラフを生成する
• 可視化結果を作業ディレクトリに保存する
• カスタム可視化コードを実行する

📦 インストール

前提条件

• Python 3.x
• uv（推奨されるパッケージマネージャー）。サーバーの管理には uv の使用をおすすめします。

インストール方法

1. MCP とその依存関係を追加する：

uv add "mcp[cli]"
uv add pandas matplotlib seaborn numpy

2. Claude Desktop でサーバーをインストールする：

mcp install server.py

pip を使用した代替インストール

pip を使用する場合は、以下のコマンドを実行します：

pip install "mcp[cli]" pandas matplotlib seaborn numpy

💻 使用例

基本的な使用法

1. MCP サーバーを起動する：

uv run mcp

2. MCP チェックツールを使用してサーバーをテストする：

mcp dev server.py

Claude Desktop でこのサーバーをインストールし、以下のコマンドを実行することですぐにサーバーとやり取りできます：

mcp install server.py

または、MCP チェックツールを使用してテストすることもできます：

mcp dev server.py

高度な使用法

このサーバーには、さまざまな機能を提供するツールが用意されています。以下にいくつかの例を示します。

データ管理

• send_work_dir()：現在の作業ディレクトリを取得する
• set_work_dir(new_work_dir)：新しい作業ディレクトリを設定する
• list_work_dir_files()：作業ディレクトリ内のファイルを一覧表示する
• load_csv(filename)：CSV ファイルをシステムに読み込む
• save_global_df(filename)：現在のデータフレームをファイルに保存する

データ前処理

• handle_column_mixed_types()：混合データ型の列を処理する
• handle_null_values(strategy, columns)：さまざまな戦略を使用して欠損値を処理する
• drop_columns(columns)：指定された列を削除する
• rename_columns(column_mapping)：データフレーム内の列名を変更する
• run_custom_df_edit_code(code)：カスタムデータフレーム編集コードを実行する

データ分析

• describe_df()：データフレームの統計的な要約を生成する
• generate_correlation_matrix()：相関行列を作成し、可視化する

データ可視化

• plot_graph(graph_type, x_column, y_column, output_filename)：さまざまなタイプのグラフを作成する
  • サポートされるグラフタイプ：'line', 'bar', 'scatter', 'histogram', 'box', 'violin', 'pie', 'count'
• run_custom_viz_code(code)：カスタム可視化コードを実行する

🔧 技術詳細

環境変数

• WORK_DIR: サーバーのデフォルト作業ディレクトリのパス。

エラー処理

このサーバーは、ファイルが見つからない、無効なパラメーターなど、さまざまなエラータイプをサポートしています。