MCP Excel Server

🚀 Excel MCP サーバー

Excel MCP サーバーは、Excel ファイルの包括的な管理とデータ分析機能を提供する MCP サーバーです。このサーバーを利用することで、Excel ファイルの操作やデータの分析、可視化を効率的に行うことができます。

✨ 主な機能

• Excel ファイル操作

  • 複数の Excel 形式（XLSX、XLS、CSV、TSV、JSON）の読み取りに対応
  • Excel ファイルの書き込みと更新
  • ファイル情報とシート名の取得

• データ分析

  • 集計統計と記述的分析
  • データ品質評価
  • データピボットテーブルの作成
  • データのフィルタリングとクエリ

• データ可視化

  • Excel データからグラフやチャートを生成
  • データのプレビューを作成
  • 可視化結果を画像としてエクスポート

📦 インストール

Python 環境の作成

新しい Python 環境を作成することをおすすめします。以下の方法で環境を作成できます。

uv を使用する場合

uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate  # Windows の場合は .venv\Scripts\activate

pip を使用する場合

python -m venv .venv
source .venv/bin/activate  # Windows の場合は .venv\Scripts\activate

依存関係のインストール

uv を使用する場合

uv pip install -r requirements.txt

pip を使用する場合

pip install -r requirements.txt

📚 ドキュメント

Claude Desktop への統合

1. Claude Desktop をインストールします。
2. 設定を開き、開発者オプションタブに移動します。
3. claude_desktop_config.json を編集します。

{
  "mcpServers": {
      "command": "uvx",
      "args": [
        "mcp-excel-server"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/python"
      }
  }
}

利用可能なツール

ファイル読み取り

• read_excel：Excel ファイルを読み取ります。
• get_excel_info：ファイルの詳細情報を取得します。
• get_sheet_names：シート名を一覧表示します。

データ分析

• analyze_excel：統計分析を実行します。
• filter_excel：条件に基づいてデータをフィルタリングします。
• pivot_table：データピボットテーブルを作成します。
• data_summary：包括的なデータ要約を生成します。

データ可視化

• export_chart：グラフを生成します。
  • 対応するグラフタイプには折れ線グラフ、棒グラフ、散布図、ヒストグラムが含まれます。

ファイル操作

• write_excel：新しい Excel ファイルに書き込みます。
• update_excel：既存の Excel ファイルを更新します。

利用可能なリソース

• excel://{file_path}：ファイルの内容を取得します。
• excel://{file_path}/info：ファイルの構造情報を取得します。
• excel://{file_path}/preview：データのプレビュー画像を生成します。

ヒントテンプレート

• analyze_excel_data：Excel データ分析のガイド付きテンプレートです。
• create_chart：データ可視化を作成するのに役立ちます。
• data_cleaning：データクリーニングを支援します。

💻 使用例

• “sales_data.xlsx ファイルを分析してください”
• “product_sales.csv の棒グラフを作成してください”
• “employees.xlsx の中で 30 歳を超える従業員を抽出してください”
• “部門の売上のピボットテーブルを生成してください”

⚠️ 重要提示

• 指定されたパスからのみファイルを読み取ります。
• ファイルサイズを制限します。
• 意図しないファイルの上書きを防止します。
• データ変換操作を厳密に管理します。

依存関係

• pandas
• numpy
• matplotlib
• seaborn

📄 ライセンス

MIT License