Lector de Excel MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para leer archivos de Excel con fragmentación y paginación automáticas. Desarrollada con SheetJS y TypeScript, esta herramienta le ayuda a gestionar archivos grandes de Excel de forma eficiente, dividiéndolos automáticamente en fragmentos manejables.

Características

📊 Leer archivos Excel (.xlsx, .xls) con límites de tamaño automáticos
🔄 Fragmentación automática para grandes conjuntos de datos
📑 Selección de hojas y paginación de filas
📅 Manejo adecuado de fechas
⚡ Optimizado para archivos grandes
🛡️ Manejo de errores y validación

Instalación

Instalación mediante herrería

Para instalar Excel Reader para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @ArchimedesCrypto/excel-reader-mcp-chunked --client claude

Como servidor MCP

Instalar globalmente:

npm install -g @archimdescrypto/excel-reader

Agregue a su archivo de configuración de MCP (generalmente en ~/.config/claude/settings.json o equivalente):

{
  "mcpServers": {
    "excel-reader": {
      "command": "excel-reader",
      "env": {}
    }
  }
}

Para el desarrollo

Clonar el repositorio:

git clone https://github.com/ArchimdesCrypto/mcp-excel-reader.git
cd mcp-excel-reader

Instalar dependencias:

npm install

Construir el proyecto:

npm run build

Uso

El lector de Excel proporciona una única herramienta read_excel con los siguientes parámetros:

interface ReadExcelArgs {
  filePath: string;      // Path to Excel file
  sheetName?: string;    // Optional sheet name (defaults to first sheet)
  startRow?: number;     // Optional starting row for pagination
  maxRows?: number;      // Optional maximum rows to read
}

// Response format
interface ExcelResponse {
  fileName: string;
  totalSheets: number;
  currentSheet: {
    name: string;
    totalRows: number;
    totalColumns: number;
    chunk: {
      rowStart: number;
      rowEnd: number;
      columns: string[];
      data: Record<string, any>[];
    };
    hasMore: boolean;
    nextChunk?: {
      rowStart: number;
      columns: string[];
    };
  };
}

Uso básico

Cuando se utiliza con Claude u otra IA compatible con MCP:

Read the Excel file at path/to/file.xlsx

La IA utilizará la herramienta para leer el archivo y gestionará automáticamente la fragmentación de archivos grandes.

Características

Fragmentación automática
- Divide automáticamente archivos grandes en fragmentos manejables
- Tamaño de fragmento predeterminado de 100 KB
- Proporciona metadatos para la paginación.
Selección de hojas
- Leer hojas específicas por nombre
- El valor predeterminado es la primera hoja si no se especifica
Paginación por filas
- Controle qué filas leer con startRow y maxRows
- Obtenga información del siguiente fragmento para una lectura continua
Manejo de errores
- Valida la existencia y el formato del archivo.
- Proporciona mensajes de error claros
- Maneja archivos de Excel malformados con elegancia

Ampliación con funciones de SheetJS

El lector de Excel está basado en SheetJS y se puede ampliar con sus potentes funciones:

Extensiones disponibles

Manejo de fórmulas
// Enable formula parsing const wb = XLSX.read(data, { cellFormula: true, cellNF: true });
Formato de celda
// Access cell styles and formatting const styles = Object.keys(worksheet) .filter(key => key[0] !== '!') .map(key => ({ cell: key, style: worksheet[key].s }));
Validación de datos
// Access data validation rules const validation = worksheet['!dataValidation'];
Características de la hoja
- Celdas fusionadas: worksheet['!merges']
- Filas/columnas ocultas: worksheet['!rows'] , worksheet['!cols']
- Protección de hoja: worksheet['!protect']

Para conocer más funciones y documentación detallada, visita la Documentación de SheetJS .

Contribuyendo

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Creado con SheetJS
Parte del ecosistema del Protocolo de Contexto Modelo

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

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

Tools

read_excel

Proporciona un manejo eficiente de archivos grandes de Excel a través de la fragmentación y paginación automáticas, utilizando MCP para permitir la lectura fluida de archivos y funciones de administración como selección de hojas y manejo de errores.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Claude Chunks
vetlefo
A
security
F
license
A
quality
An MCP server that intelligently chunks large documents for Claude, enabling efficient context-aware processing and summary generation for enhanced document comprehension.
Last updated -
12
JavaScript
Excel Reader Server
softgridinc-pte-ltd
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that provides tools for reading Excel (xlsx) files, enabling extraction of data from entire workbooks or specific sheets with results returned in structured JSON format.
Last updated -
3
5
Python
Apache 2.0
Excel MCP Server
zhiwei5576
A
security
A
license
A
quality
Enables seamless reading, writing, and analyzing of Excel files through Model Context Protocol, with features for worksheet management, structure analysis, and automated caching.
Last updated -
8
212
11
TypeScript
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

View all related MCP servers

MCP Excel Reader