File Analysis MCP Server

🚀 文件分析 MCP サーバー

このモデルコンテキストプロトコル（MCP）サーバーは、安全にファイルの読み書き、データ分析（特に CSV ファイル）、データの可視化グラフの生成、PDF ファイルの内容の抽出など、様々な機能を提供します。これらの機能は、すべて任意の MCP クライアント（Claude Desktop など）からアクセスできます。

🚀 クイックスタート

この MCP サーバーを使用することで、安全にファイル操作やデータ分析を行うことができます。以下のセクションでは、機能、インストール方法、使用方法などについて説明します。

✨ 主な機能

ファイル操作

• テキストファイルの安全な読み書き
• パターンに基づくディレクトリ内のファイルの一覧表示
• ファイルの詳細情報（サイズ、作成時間など）の取得
• PDF ファイルからのテキスト内容の抽出

データ分析

• CSV ファイルの読み取りとサンプリング
• CSV データの分析による詳細な統計情報の取得
• 複数のグラフタイプ（棒グラフ、折れ線グラフ、散布図、ヒストグラム、箱ひげ図）を使用したデータの可視化の生成

含まれるプロンプト

• 包括的なデータ分析 - データファイルの総合的な分析
• データクリーニング手順 - データの問題の識別と修正
• 要約レポートの生成 - 利害関係者向けのエグゼクティブ要約の提供
• 探索的データ分析 - 詳細な EDA ワークフロー

📦 インストール

前提条件

• Python 3.10 以上
• Claude Desktop またはその他の MCP クライアント

セットアップ

1. 依存関係のインストール：

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

2. 安全なディレクトリの設定（オプション）：

# デフォルトのディレクトリは ~/Documents と ~/Downloads です
# カスタマイズするには、以下の環境変数を設定します：
export MCP_FILE_ROOTS="~/Documents:~/Desktop:~/Downloads"

3. Claude Desktop でのインストール：

mcp install file_analysis_server.py

💻 使用例

Claude Desktop の使用

インストールが完了したら、Claude に以下のような質問をすることができます。

• 「私のドキュメントフォルダ内のファイルを一覧表示できますか？」
• 「~/Documents/example.txt ファイルの内容を読み取ってください」
• 「~/Documents/report.pdf ファイルからテキスト内容を抽出してください」
• 「PDF ドキュメントの 5 ページ目を読み取ってください」
• 「~/Downloads/sample.csv のデータを分析してください」
• 「CSV ファイルの 'Sales' 列の棒グラフを生成してください」
• 「quarterly_sales.csv ファイルの要約レポートを作成してください」

具体的な使用例

ファイルの読み取り

~/Documents/notes.txt ファイルの内容を読んでくれますか？

PDF ファイルの読み取り

~/Documents/report.pdf ファイルからテキスト内容を抽出できますか？

特定のページの PDF ファイルの読み取り

~/Downloads/manual.pdf の 3 ページ目と 5 ページ目を読んでください。

CSV データの分析

~/Downloads/sales_data.csv ファイルにいくつかのデータがあります。'Revenue' 列の状況を分析できますか？

可視化グラフの作成

~/Documents/monthly_data.csv ファイルを使用して、'Month' と 'Profit' の関係を示す棒グラフを生成できますか？

プロンプトの使用

~/Downloads/customer_data.csv ファイルに対して探索的データ分析を実行できますか？

🔧 技術詳細

セキュリティ

このサーバーは、パス検証を厳密に実行し、承認されたディレクトリ内のファイルのみにアクセスできるようにしています。デフォルトでは、これらのディレクトリは ~/Documents と ~/Downloads に限定されています。

設定

MCP_FILE_ROOTS 環境変数を設定することで、許可されるディレクトリを調整することができます。複数のディレクトリはコロンで区切ります。例えば：

mcp install file_analysis_server.py -v MCP_FILE_ROOTS="~/Documents:~/Desktop:~/projects/data"

開発

開発とテストには、以下のコマンドを使用します。

mcp dev file_analysis_server.py

これにより、MCP インスペクターインターフェイス付きのサーバーが起動し、対話的なテストが可能になります。