Servidor Excel MCP

Chino tradicional | Inglés

Servidor de procesamiento de archivos Excel basado en el Protocolo de Contexto de Modelo (MCP), que proporciona funcionalidades para leer, escribir y analizar archivos Excel.

Características

• 📖 Leer archivos de Excel
  • Obtener lista de hojas de trabajo
  • Leer datos específicos de la hoja de trabajo
  • Leer todos los datos de las hojas de trabajo
• ✍️ Escribir archivos de Excel
  • Crear nuevos archivos de Excel
  • Escribir en una hoja de trabajo específica
  • Admite múltiples hojas de trabajo
• 🔍Analizar la estructura de Excel
  • Analizar la estructura de la hoja de trabajo
  • Exportar estructura a un nuevo archivo
• 💾 Gestión de caché
  • Almacenamiento automático en caché del contenido de los archivos
  • Limpieza de caché programada
  • Borrado manual de caché
• 📝 Gestión de registros
  • Registro automático de operaciones
  • Limpieza periódica de registros

Instalación

Instalación mediante herrería

Para instalar excel-mcp-server para Claude Desktop automáticamente a través de Smithery :

Instalación manual

La instalación a través de NPM excel-mcp-server se puede instalar automáticamente agregando la siguiente configuración a la configuración de los servidores MCP.

Plataforma Windows:

Otras plataformas:

Nota: LOG_PATH es opcional. Si no se configura, los registros se almacenarán en la carpeta 'logs', dentro del directorio raíz de la aplicación. Los demás argumentos son opcionales.

Herramientas API

Herramientas de estructura

1. analizarEstructuraExcel
   • Función: Obtener la estructura del archivo de Excel, incluida la lista de hojas y los encabezados de columna en formato JSON
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel
     • headerRows: Número de filas de encabezado (predeterminado: 1)
2. exportarEstructuraExcel
   • Función: Exportar la estructura del archivo de Excel (hojas y encabezados) a un nuevo archivo de plantilla de Excel
   • Parámetros:
     • sourceFilePath: Ruta del archivo fuente de Excel
     • targetFilePath: Ruta del archivo de Excel de destino
     • headerRows: Número de filas de encabezado (predeterminado: 1)

Leer herramientas

1. leerNombresDeHojas
   • Función: Obtener todos los nombres de hojas del archivo de Excel
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel
2. leerDatosPorNombreDeHoja
   • Función: Obtener datos de una hoja específica en el archivo Excel
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel
     • sheetName: Nombre de la hoja a leer
     • headerRow: Número de fila del encabezado (predeterminado: 1)
     • dataStartRow: Número de fila de inicio de datos (predeterminado: 2)
3. leerHojaDatos
   • Función: Obtener datos de todas las hojas del archivo Excel
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel
     • headerRow: Número de fila del encabezado (predeterminado: 1)
     • dataStartRow: Número de fila de inicio de datos (predeterminado: 2)

Herramientas de escritura

1. escribirDatosPorNombreDeHoja
   • Función: Escribe datos en una hoja específica en el archivo Excel (sobrescribe si la hoja existe)
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel
     • sheetName: Nombre de la hoja donde escribir
     • datos: Matriz de datos para escribir
2. escribirHojaDatos
   • Función: Crea un nuevo archivo de Excel con los datos proporcionados
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta para el nuevo archivo de Excel
     • datos: Objeto que contiene datos de varias hojas

Herramientas de caché

1. borrar caché de archivos
   • Función: Borrar los datos almacenados en caché del archivo de Excel especificado
   • Parámetros:
     • fileAbsolutePath: Ruta absoluta del archivo de Excel que se borrará de la caché

Configuración

Variables de entorno

• LOG_PATH : Ruta de almacenamiento de archivos de registro
  • Opcional
  • Valor predeterminado: carpeta 'registros' en el directorio raíz de la aplicación
• CACHE_MAX_AGE : Tiempo de expiración de la caché (horas)
  • Opcional
  • Predeterminado: 1
• CACHE_CLEANUP_INTERVAL : Intervalo de limpieza de caché (horas)
  • Opcional
  • Predeterminado: 4
• LOG_RETENTION_DAYS : Días de retención de registros
  • Opcional
  • Predeterminado: 7
• LOG_CLEANUP_INTERVAL : Intervalo de limpieza de registros (horas)
  • Opcional
  • Predeterminado: 24

Configuración predeterminada

• Configuración de caché
  • Tiempo de expiración de la caché: 1 hora
  • Intervalo de limpieza de caché: 4 horas
• Configuración de registro
  • Días de retención de registros: 7 días
  • Intervalo de limpieza: 24 horas

Dependencias

• @modelcontextprotocol/sdk: ^1.7.0
• xlsx: ^0.18.5
• mecanografiado: ^5.8.2

Dependencias de desarrollo

• @tipos/nodo: ^22.13.10
• nodemon: ^3.1.9
• nodo ts: ^10.9.2

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Esto significa que usted tiene la libertad de:

• Utilizar el software con fines comerciales o no comerciales
• Modificar el código fuente
• Distribuir código original o modificado Requisitos:
• Conserve el aviso de derechos de autor original
• No se podrá reclamar ninguna responsabilidad a los autores por el uso del software. Para obtener información detallada sobre la licencia, consulte el archivo LICENCIA .