local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides tools for reading and parsing Excel (.xlsx) files using Python, enabling extraction of data from entire workbooks or specific sheets by name or index.

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.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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

Excel Reader Server