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

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

1. Instalar globalmente:

npm install -g @archimdescrypto/excel-reader

2. 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

1. Clonar el repositorio:

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

2. Instalar dependencias:

npm install

3. Construir el proyecto:

npm run build

Uso

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

1. 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.

2. Selección de hojas

   • Leer hojas específicas por nombre

   • El valor predeterminado es la primera hoja si no se especifica

3. Paginación por filas

   • Controle qué filas leer con startRow y maxRows

   • Obtenga información del siguiente fragmento para una lectura continua

4. 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

1. Manejo de fórmulas

   // Enable formula parsing
   const wb = XLSX.read(data, {
     cellFormula: true,
     cellNF: true
   });

2. 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
     }));

3. Validación de datos

   // Access data validation rules
   const validation = worksheet['!dataValidation'];

4. 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

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. 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