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.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.