Сервер чтения Excel

Сервер протокола контекста модели (MCP), предоставляющий инструменты для чтения файлов Excel (xlsx).

Функции

• Прочитать содержимое всех листов файла 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

Зависимости

• мср >= 1.2.1

• openpyxl >= 3.1.5

Использование

Сервер предоставляет три основных инструмента:

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.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.