Sobre el proyecto

Excel MCP Server es un servidor del Protocolo de Contexto de Modelo que brinda a los asistentes de IA la capacidad de crear, leer y editar libros de Excel. No requiere una instalación de Microsoft Excel. Funciona con archivos .xlsx, .xlsm (macros conservadas), .xltx y .xltm. Capacidades - Leer y escribir celdas, fórmulas y fechas, con paginación para hojas grandes y búsqueda de celdas. - Dar formato a fuentes, rellenos, bordes, formatos de número, anchos de columna y paneles inmovilizados. - Gestionar la estructura: hojas, filas y columnas, celdas combinadas, tablas, gráficos y tablas de resumen. - Aplicar reglas: formato condicional y validación de datos, como listas desplegables y límites numéricos. - Leer código VBA en archivos .xlsm módulo por módulo (solo lectura, nunca se ejecuta). Funciones de seguridad - Confinamiento opcional de carpetas mediante --allow-dir o EXCEL_FILES_PATH; las rutas relativas se resuelven dentro de las carpetas permitidas. - La comprobación de seguridad de fórmulas rechaza funciones que acceden a la red, a otros programas o a información del host (por ejemplo WEBSERVICE, HYPERLINK, IMAGE, RTD, CALL, INFO, INDIRECT), enlaces DDE y referencias a libros externos. - Modo de solo lectura, un tamaño máximo de archivo (100 MB por defecto), un límite de 100.000 celdas por llamada y guardados atómicos. - El modo HTTP escucha en localhost por defecto; el acceso remoto requiere un token de portador y se recomienda un proxy inverso con terminación TLS. Configuración Los clientes suelen ejecutar el servidor con uvx excel-mcp-server stdio, opcionalmente con --allow-dir. Las integraciones documentadas incluyen Claude Desktop (incluido un paquete .mcpb), Claude Code, Cursor, VS Code con GitHub Copilot, OpenAI Codex, Gemini CLI y Devin Desktop. Hay disponible un modo HTTP transmitible, con soporte para Docker. Las áreas de herramientas incluyen libros (crear, describir, listar, exportar, importar), hojas (describir, crear, renombrar, copiar, eliminar, insertar/eliminar filas o columnas), celdas (read_range, write_range, clear_range, copy_range, find_cells), formato (format_range, merge_cells, set_sheet_layout, add_conditional_format, add_data_validation), objetos (create_table, create_chart, create_summary_table) y macros (read_vba). Limitaciones - Las fórmulas se almacenan, no se calculan; el modo de valores devuelve los resultados que Excel guardó por última vez, por lo que las fórmulas recién escritas se leen como vacías hasta que se abran y se guarden en Excel o LibreOffice. - No se admiten archivos heredados .xls ni .csv. - create_summary_table escribe un resumen estático; no se crean tablas dinámicas reales. - Insertar o eliminar filas y columnas no actualiza las fórmulas, los gráficos ni las tablas que hacen referencia a las celdas desplazadas. - Las funciones que openpyxl no entiende, como formas, segmentaciones de datos y algunos objetos incrustados, pueden perderse al editar; las imágenes, los gráficos, las tablas y las macros en archivos .xlsm se conservan. La versión 1.0 renombró y rediseñó las herramientas, eliminó el transporte SSE y requiere Python 3.11 o superior. Con licencia MIT.