MCP Excel Reader Server

🚀 Excel 読者サーバー

Excel（xlsx）ファイルを読み取るツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。

✨ 主な機能

• Excel ファイル内のすべてのシートの内容を読み取る
• 名前を指定して特定のシートの内容を読み取る
• インデックスを指定して特定のシートの内容を読み取る
• JSON 形式のデータを返す
• 空のセルとデータ型の変換を処理する

📦 インストール

Python 3.10 以上が必要です。

# pip を使用する場合
pip install excel-reader-server

# uv を使用する場合（推奨）
uv pip install excel-reader-server

🔧 依存関係

• mcp >= 1.2.1
• openpyxl >= 3.1.5

💻 使用例

基本的な使用法

サーバーは3つの主要なツールを提供しています。

1. read_excel

Excel ファイル内のすべてのシートの内容を読み取ります。

{
  "file_path": "path/to/your/excel/file.xlsx"
}

2. read_excel_by_sheet_name

名前を指定して特定のシートの内容を読み取ります。シート名が指定されない場合は、最初のシートを読み取ります。

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_name": "Sheet1"  # オプションのパラメータ
}

3. read_excel_by_sheet_index

インデックスを指定して特定のシートの内容を読み取ります。インデックスが指定されない場合は、最初のシート（インデックス 0）を読み取ります。

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_index": 0  # オプションのパラメータ
}

高度な使用法

レスポンス形式

サーバーは以下の JSON 形式でデータを返します。

{
  "Sheet1": [
    ["Header1", "Header2", "Header3"],
    ["Value1", "Value2", "Value3"],
    ["Value4", "Value5", "Value6"]
  ]
}

• 各シートはトップレベルのオブジェクトのキーとして表されます。
• シートのデータは配列で、各内部配列は行を表します。
• すべての値は文字列に変換されます。
• 空のセルは空の文字列として表されます。

エラー処理

サーバーは、一般的な問題に対して明確なエラーメッセージを提供します。

• ファイルが見つからない
• 無効なシート名
• インデックスが範囲外
• 一般的な Excel ファイル読み取りエラー

📄 ライセンス

このプロジェクトは Apache 2 ライセンスの下で公開されています。詳細については、LICENSE ファイルを参照してください。

🔗 貢献

貢献を歓迎します！自由に Pull Request を送信してください。