Lector de Excel MCP

Name: MCP Excel Reader
Author: ArchimedesCrypto

insignia de herrería 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

Related MCP server: Excel MCP Server

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']