Excel Reader Server Hby

🚀 Excel 読み取りサーバー

Excel（xlsx）ファイルを読み取るためのツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、Excelファイルの内容をJSON形式で取得することができ、様々なシート読み取り方法やエラーハンドリング機能を備えています。

✨ 主な機能

• ファイル内のすべてのシートの内容を読み取る
• 名前で特定のシートの内容を読み取る
• インデックスで特定のシートの内容を読み取る
• 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

💻 使用例

基本的な使用法

1. read_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"]
  ]
}

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

📚 ドキュメント

エラー処理

サーバーは一般的な問題を処理するための明確なエラーメッセージを提供します。

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

📄 ライセンス

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

🔗 貢献ガイド

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