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 toolsread_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
Scored across 3 tools
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.
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.
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.
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
Related MCP Connectors
The Excel engine for AI agents: read, check and edit Excel models over MCP.
Hosted MCP: CSV/XLSX to JSON rows and text-PDF pages; private uploads or URLs, no API key.
Token-free MCP server for structured RevoGrid Core, Pro, and Enterprise knowledge retrieval.
Read-only MCP over your Excel or Airtable plus the PDFs beside it, joined as one relational dataset.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants to read from and write to Microsoft Excel files, supporting formats like xlsx, xlsm, xltx, and xltm.61,051MIT
- AlicenseAqualityBmaintenanceA 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.619MIT
- AlicenseAqualityDmaintenanceMCP server for reading and writing Excel (xlsx) files using SheetJS, providing tools to list sheets, read data, create files, add sheets, and update cells.510 npmMIT
- AlicenseAqualityCmaintenanceMCP server for reading and inspecting local Excel files (.xlsx, .xlsm, .xls, .xlsb, .ods) with tools for inspecting metadata, reading ranges, and profiling structure.36 npmMIT