Excel リーダー サーバー
Excel (xlsx) ファイルを読み取るためのツールを提供するモデル コンテキスト プロトコル (MCP) サーバー。
特徴
Excel ファイル内のすべてのシートのコンテンツを読み取る
特定のシートの内容を名前で読み取る
インデックスによって特定のシートのコンテンツを読み取る
JSON形式でデータを返します
空のセルとデータ型の変換を処理します
Related MCP server: Excel MCP Server
インストール
Python 3.10 以上が必要です。
# Using pip
pip install excel-reader-server
# Using uv (recommended)
uv pip install excel-reader-server
依存関係
mcp >= 1.2.1
openpyxl >= 3.1.5
使用法
サーバーは 3 つの主なツールを提供します。
1. Excelを読む
Excel ファイル内のすべてのシートからコンテンツを読み取ります。
{
"file_path": "path/to/your/excel/file.xlsx"
}
2. シート名でExcelを読み込む
特定のシートから名前でコンテンツを読み取ります。シート名が指定されていない場合は、最初のシートを読み取ります。
{
"file_path": "path/to/your/excel/file.xlsx",
"sheet_name": "Sheet1" # optional
}
3. シートインデックスでExcelを読み込む
インデックスを指定して特定のシートからコンテンツを読み取ります。インデックスが指定されていない場合は、最初のシート（インデックス0）を読み取ります。
{
"file_path": "path/to/your/excel/file.xlsx",
"sheet_index": 0 # optional
}
応答フォーマット
サーバーは次の JSON 形式でデータを返します。
{
"Sheet1": [
["Header1", "Header2", "Header3"],
["Value1", "Value2", "Value3"],
["Value4", "Value5", "Value6"]
]
}
各シートはトップレベルオブジェクトのキーとして表されます
シートデータは配列の配列であり、各内部配列は行を表します。
すべての値は文字列に変換されます
空のセルは空の文字列として表されます
エラー処理
サーバーは、一般的な問題に対して明確なエラー メッセージを提供します。
ファイルが見つかりません
シート名が無効です
インデックスが範囲外です
一般的なExcelファイルの読み取りエラー
ライセンス
このプロジェクトはApache 2ライセンスに基づいてリリースされています。詳細はLICENSEファイルをご覧ください。
貢献
貢献を歓迎します！お気軽にプルリクエストを送信してください。