Excel MCP Server

Excel MCP Server

包括的な Excel ファイル管理およびデータ分析機能を提供する MCP サーバーです。

機能

• Excel ファイル操作

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

• データ分析

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

• 可視化

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

インストール

1. 新しい Python 環境を作成します（推奨）：

# Using uv (recommended)
uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Or using pip
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. 依存関係をインストールします：

# Using uv
uv pip install -e .

Claude Desktop との連携

1. Claude Desktop をインストールします
2. 設定を開き、「Developer」タブに移動します
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