Excel MCP

🚀 FastMCP 2.0

FastMCP 2.0は、大規模言語モデル（Claudeなど）がExcelファイルを読み、探索し、分析することを可能にするModel Context Protocol (MCP)サーバーです。このサーバーを使用することで、ExcelファイルをAIが理解し、クエリできるインタラクティブなデータセットに変換できます。

███████╗██╗  ██╗ ██████╗███████╗██╗         ███╗   ███╗ ██████╗██████╗ 
██╔════╝╚██╗██╔╝██╔════╝██╔════╝██║         ████╗ ████║██╔════╝██╔══██╗
█████╗   ╚███╔╝ ██║     █████╗  ██║         ██╔████╔██║██║     ██████╔╝
██╔══╝   ██╔██╗ ██║     ██╔══╝  ██║         ██║╚██╔╝██║██║     ██╔═══╝ 
███████╗██╔╝ ██╗╚██████╗███████╗███████╗    ██║ ╚═╝ ██║╚██████╗██║     
╚══════╝╚═╝  ╚═╝ ╚═════╝╚══════╝╚══════╝    ╚═╝     ╚═╝ ╚═════╝╚═╝     

📊 サーバー名: Excel Explorer 📦 トランスポート: Streamable-HTTP / Direct 🔗 サーバーURL: http://127.0.0.1:8000/mcp

📚 ドキュメント: https://gofastmcp.com 🚀 デプロイ: https://fastmcp.cloud

⚡ FastMCPバージョン: 2.10.6 🔧 MCPバージョン: 1.12.3

🚀 クイックスタート

依存関係のインストール

# 環境のセットアップ (オプション)
source activate-pipx.sh

# 依存関係のインストール
uv sync

必要条件:

• Python >=3.13
• fastmcp >=2.10.6
• pandas >=2.3.1
• openpyxl >=3.1.5
• xlrd >=2.0.2
• pytest >=8.4.1

MCPサーバーの起動

python main.py

または

fastmcp run main.py:mcp --transport http --host 127.0.0.1 --port 8000 --path /mcp

サーバーが起動し、MCP接続を待機します。サーバーが正常に起動したことを確認する出力が表示されます。

テスト

# すべてのテストを実行
python -m pytest tests/ -v

# 特定のテストファイルを実行
python -m pytest tests/test_file_operations.py -v
python -m pytest tests/test_data_discovery.py -v

# カバレッジを含める
python -m pytest tests/ --cov=src --cov-report=html

Claudeとの統合

1. Claude Desktopの統合

Claude Desktopの設定ファイル (claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "excel-explorer": {
      "command": "python",
      "args": ["/path/to/excel-mcp/main.py"],
      "env": {}
    }
  }
}

または

{
    "excelExplorer": {
        "command": "npx",
        "args": [
            "-y",
            "mcp-remote",
            "http://127.0.0.1:8000/mcp"
        ],
        "env": {
            "MCP_TRANSPORT_STRATEGY": "http-only"
        }
    }
}

2. 利用可能なツール

接続後、Claudeは以下のツールを使用できます。

ファイル操作:

• load_excel(file_path, sheet_name) - Excelファイルを読み込む
• list_sheets(file_path) - すべてのシートを一覧表示する
• get_file_info(file_path) - ファイルのメタデータを取得する
• clear_cache() - メモリをクリアする

データ探索:

• get_schema(file_path, sheet_name) - 列の型と統計情報を取得する
• get_sample_data(file_path, rows=5, sample_type="head") - サンプルデータを取得する
• get_column_info(file_path, column_name) - 列の分析情報を取得する
• get_dimensions(file_path) - データセットのサイズとメモリを取得する
• describe_dataset(file_path, include_all=False) - 統計的な要約を取得する

3. Claudeでの使用例

あなた: "data/dataset.xlsxファイルを読み込み、その構造について教えて"

Claudeは以下を使用します。
1. load_excel("data/dataset.xlsx")
2. get_schema("data/dataset.xlsx")
3. get_dimensions("data/dataset.xlsx")
4. describe_dataset("data/dataset.xlsx")

その後、あなたのデータに関する洞察を提供します！

AIでExcelデータの探索を始めましょう！ 🚀📊