Excel Reader Server Hby

🚀 Excel 讀取器服務器

Excel 讀取器服務器是一個基於模型上下文協議（MCP）的服務器，它提供了強大的工具，能夠輕鬆讀取 Excel（xlsx）文件，為數據處理和分析提供便利。

🚀 快速開始

Excel 讀取器服務器是一個實用的工具，它能幫助你高效地讀取 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"]
  ]
}

• 每個工作表以頂級對象中的鍵表示。
• 工作表數據是一個數組，其中每個內部數組代表一行數據。
• 所有值均轉換為字符串類型。
• 空單元格表示為空字符串。

錯誤處理

服務器提供清晰的錯誤消息以處理常見問題：

• 文件未找到。
• 無效的工作表名稱。
• 索引超出範圍。
• 通用 Excel 文件讀取錯誤。

📄 許可證

該項目在 MIT 許可證下發布。有關詳細信息，請參閱 LICENSE 文件。

💡 貢獻指南

歡迎貢獻！請隨意提交 Pull Request。