Skip to main content
Glama
Excel Reader Server

Excel Reader Server

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

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

Функции

  • Прочитать содержимое всех листов файла Excel

  • Прочитать содержимое определенного листа по названию

  • Прочитать содержимое с определенного листа по индексу

  • Возвращает данные в формате JSON

  • Обрабатывает пустые ячейки и преобразования типов данных

Related MCP server: OpenPyXL 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.

Внося вклад

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

Available Tools

3 tools
read_excelC

Read content from Excel (xlsx) files

Inputs: file_path (required).

read_excel_by_sheet_indexA

Read content from a specific sheet by index in Excel (xlsx) files. Reads first sheet (index 0) if sheet_index not provided.

Inputs: file_path (required), sheet_index.

read_excel_by_sheet_nameA

Read content from a specific sheet by name in Excel (xlsx) files. Reads first sheet if sheet_name not provided.

Inputs: file_path (required), sheet_name.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 3 tools

    Disambiguation2/5

    The tools have significant overlap in purpose, as all three are focused on reading Excel files, with only minor variations in how they specify the sheet. An agent might easily confuse them or struggle to choose the right one for a given task, since the distinctions are subtle and not clearly differentiated in the descriptions.

    Naming Consistency5/5

    The tool names follow a consistent verb_noun pattern with 'read_excel' as the base, and suffixes like '_by_sheet_index' and '_by_sheet_name' that clearly indicate the specific functionality. This makes the naming predictable and easy to understand across the set.

    Tool Count3/5

    With only 3 tools, the server feels thin for a domain like Excel reading, which might benefit from additional operations such as writing, listing sheets, or handling different file formats. However, the count is not extreme and could be considered borderline for basic functionality.

    Completeness2/5

    The tool set is severely incomplete for an Excel server, as it only covers reading operations and lacks any writing, updating, or other common Excel functionalities like formatting, formula evaluation, or metadata access. This will likely cause agent failures when more comprehensive tasks are required.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A thin wrapper around the OpenPyXl Python library that exposes Excel file operations as a Model Context Protocol (MCP) server, allowing Claude and other MCP clients to fetch and analyze data from Excel files.
      6
      19
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for reading and writing Excel (xlsx) files using SheetJS, providing tools to list sheets, read data, create files, add sheets, and update cells.
      5
      10 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for reading and inspecting local Excel files (.xlsx, .xlsm, .xls, .xlsb, .ods) with tools for inspecting metadata, reading ranges, and profiling structure.
      3
      6 npm
      MIT