Servidor de lectura de Excel

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona herramientas para leer archivos Excel (xlsx).

Características

Leer el contenido de todas las hojas de un archivo Excel
Leer el contenido de una hoja específica por nombre
Leer el contenido de una hoja específica por índice
Devuelve datos en formato JSON
Maneja celdas vacías y conversiones de tipos de datos

Instalación

Requiere Python 3.10 o superior.

# Using pip
pip install excel-reader-server

# Using uv (recommended)
uv pip install excel-reader-server

Dependencias

mcp >= 1.2.1
openpyxl >= 3.1.5

Uso

El servidor proporciona tres herramientas principales:

1. leer_excel

Lee el contenido de todas las hojas de un archivo Excel.

{
  "file_path": "path/to/your/excel/file.xlsx"
}

2. leer_excel_por_nombre_de_hoja

Lee el contenido de una hoja específica por nombre. Si no se proporciona el nombre de la hoja, lee la primera hoja.

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_name": "Sheet1"  # optional
}

3. leer_excel_por_índice_de_hoja

Lee el contenido de una hoja específica por índice. Si no se proporciona índice, lee la primera hoja (índice 0).

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_index": 0  # optional
}

Formato de respuesta

El servidor devuelve datos en el siguiente formato JSON:

{
  "Sheet1": [
    ["Header1", "Header2", "Header3"],
    ["Value1", "Value2", "Value3"],
    ["Value4", "Value5", "Value6"]
  ]
}

Cada hoja se representa como una clave en el objeto de nivel superior.
Los datos de la hoja son una matriz de matrices, donde cada matriz interna representa una fila
Todos los valores se convierten en cadenas
Las celdas vacías se representan como cadenas vacías

Manejo de errores

El servidor proporciona mensajes de error claros para problemas comunes:

Archivo no encontrado
Nombre de hoja no válido
Índice fuera de rango
Errores generales de lectura de archivos de Excel

Licencia

Este proyecto se publica bajo la licencia Apache 2. Consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para leer archivos Excel (xlsx), lo que permite la extracción de datos de libros de trabajo completos u hojas específicas con resultados devueltos en formato JSON estructurado.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Excel MCP Server
negokaz
-
security
A
license
-
quality
A 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.
Last updated -
5,299
272
Go
MIT License
MCP Local File Reader
sworddut
-
security
A
license
-
quality
A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
Last updated -
47
1
JavaScript
MIT License
Excel MCP Server
yzfly
A
security
F
license
A
quality
An MCP server that provides comprehensive Excel file operations, data analysis, and visualization capabilities for working with various spreadsheet formats like XLSX, CSV, and JSON.
Last updated -
8
36
Python
MCP Hub Tools
hekmon8
A
security
F
license
A
quality
An MCP server that allows searching for and retrieving information about Model Context Protocol servers registered on the MCP Hub.
Last updated -
1
JavaScript

View all related MCP servers

Excel Reader Server