Excel MCP Server

Manipula archivos Excel (XLSX, XLSM, etc.) sin necesidad de Microsoft Excel, con un asistente de IA integrado.

Documentación

Excel MCP Server - Protocolo de Contexto de Modelo para Excel sin Microsoft Excel

Un servidor de Protocolo de Contexto de Modelo (MCP) que te permite manipular archivos de Excel sin necesidad de tener Microsoft Excel instalado. Crea, lee, escribe y analiza libros de trabajo de Excel (.xlsx, .xlsm) con asistentes de IA como Claude. Automatización completa de Excel mediante integración con LLM.

Características principales:

✅ Lee y escribe archivos de Excel sin Microsoft Excel
✅ Soporte completo para formatos XLSX, XLSM, XLTX, XLTM
✅ Crea gráficos, tablas dinámicas y paneles
✅ Importa/exporta CSV, JSON, SQL, PDF
✅ Funciona con Claude AI y otros asistentes LLM
✅ Multiplataforma: Windows, macOS, Linux
✅ Instalación sencilla mediante npm/npx

🌟 Características - Excel MCP Server

Manipulación completa de Excel sin Microsoft Excel

📊 Operaciones con archivos de Excel: Lee y escribe archivos XLSX, XLSM, XLTX, XLTM
📖 Extracción de datos: Lee datos de hojas de Excel con soporte de paginación
✍️ Operaciones de escritura: Escribe datos y fórmulas en libros de trabajo de Excel
📋 Gestión de hojas: Crea, elimina, renombra y copia hojas de cálculo
📈 Gráficos y visualizaciones: Crea gráficos, tablas dinámicas y paneles
🔄 Importación/exportación de datos: Importa desde CSV, JSON, SQL y exporta a múltiples formatos
🎨 Formato profesional: Estilo y formato automáticos para documentos de Excel

Capacidades principales

📊 Operaciones de datos

Lee y escribe archivos de Excel con soporte completo de formato
Crea tablas profesionales con estilo automático
Genera gráficos y visualizaciones
Importa desde fuentes CSV, JSON y SQL
Exporta a múltiples formatos (CSV, JSON, PDF)

🎨 Formato profesional

Ajuste automático del ancho de columnas
Formato y estilo de texto enriquecido
Esquemas de color y temas profesionales
Generación de documentos listos para publicación

🏗️ Funciones avanzadas

Paneles dinámicos con múltiples visualizaciones
Generación de informes basada en plantillas
Filtrado y análisis de datos
Tablas dinámicas y cálculos avanzados
Procesamiento por lotes y automatización

🔐 Seguridad y confianza

Puntuación de seguridad: 100/100 | Nivel de riesgo: Bajo

Este proyecto ha sido auditado de forma independiente por MseeP.ai, que proporciona validación de seguridad continua y evaluación de confianza para el ecosistema MCP.

🚀 Inicio rápido - Instalación de Excel MCP Server

Instalación

La forma más sencilla de usar Excel MCP Server es con npx (no se requiere instalación):

npx @guillehr2/excel-mcp-server@latest

O instalar globalmente:

npm install -g @guillehr2/excel-mcp-server

Configuración

Añade a la configuración de tu cliente MCP (por ejemplo, Claude Desktop):

Usando npx (Recomendado)

{
  "mcpServers": {
    "excel-master": {
      "command": "npx",
      "args": [
        "-y",
        "@guillehr2/excel-mcp-server@latest"
      ]
    }
  }
}

Usando una versión específica

{
  "mcpServers": {
    "excel-master": {
      "command": "npx",
      "args": [
        "-y",
        "@guillehr2/excel-mcp-server@1.0.7"
      ]
    }
  }
}

Usando instalación global

{
  "mcpServers": {
    "excel-master": {
      "command": "excel-mcp-server"
    }
  }
}

Modo de desarrollo

Si estás desarrollando o quieres ejecutar desde el código fuente:

{
  "mcpServers": {
    "excel-master": {
      "command": "node",
      "args": ["path/to/Excel-MCP-Server-Master/index.js"]
    }
  }
}

🛠️ Herramientas de Excel MCP Server - Automatización completa de Excel

Operaciones con archivos de Excel sin Microsoft Excel

Crear libros de trabajo de Excel - create_workbook_tool
Abrir archivos de Excel - open_workbook_tool (XLSX, XLSM, XLTX, XLTM)
Guardar archivos de Excel - save_workbook_tool
Listar hojas de Excel - list_sheets_tool
Gestionar hojas de cálculo - add_sheet_tool, delete_sheet_tool, rename_sheet_tool

Manipulación de datos de Excel

Escribir en Excel - write_sheet_data_tool, update_cell_tool
Leer desde Excel - Extracción de datos integrada con paginación
Tablas de Excel - add_table_tool, create_formatted_table_tool
Fórmulas de Excel - Soporte completo de fórmulas en todas las operaciones de escritura

Gráficos y análisis de Excel

Crear gráficos de Excel - add_chart_tool (columnas, barras, líneas, circulares, dispersión)
Paneles de Excel - create_dashboard_tool
Tablas dinámicas - Análisis avanzado de datos
Filtrado de datos - filter_data_tool

Importar/Exportar datos de Excel

Importar a Excel - import_data_tool (CSV, JSON, SQL)
Exportar desde Excel - export_data_tool (CSV, JSON, PDF)
Exportación a PDF - export_single_sheet_pdf_tool, export_sheets_pdf_tool

💡 Ejemplos de uso

Crear un informe profesional

# Create a new workbook with formatted data
result = create_formatted_table_tool(
    file_path="sales_report.xlsx",
    sheet_name="Q4 Sales",
    start_cell="A1",
    data=[
        ["Region", "Q4 Sales", "Growth %"],
        ["North", 125000, 15.2],
        ["South", 98000, 8.7],
        ["East", 156000, 22.1],
        ["West", 89000, -3.2]
    ],
    table_name="Q4SalesData",
    table_style="TableStyleMedium9",
    formats={
        "B2:B5": "#,##0",  # Number format for sales
        "C2:C5": "0.0%",   # Percentage format
        "A1:C1": {"bold": True, "fill_color": "366092"}  # Header styling
    }
)

# Add a chart based on the table data
chart_result = add_chart_tool(
    file_path="sales_report.xlsx",
    sheet_name="Q4 Sales",
    chart_type="column",
    data_range="A1:B5",
    title="Q4 Sales by Region",
    position="E2",
    style="colorful-1"
)

Crear un panel dinámico

# Create a comprehensive dashboard
dashboard_result = create_dashboard_tool(
    file_path="executive_dashboard.xlsx",
    data={
        "Data": [
            ["Month", "Revenue", "Expenses", "Profit"],
            ["Jan", 50000, 30000, 20000],
            ["Feb", 55000, 32000, 23000],
            ["Mar", 48000, 29000, 19000]
        ]
    },
    dashboard_config={
        "tables": [
            {
                "sheet": "Dashboard",
                "name": "MonthlyData",
                "range": "Data!A1:D4",
                "style": "TableStyleMedium9"
            }
        ],
        "charts": [
            {
                "sheet": "Dashboard",
                "type": "line",
                "data_range": "Data!A1:B4",
                "title": "Revenue Trend",
                "position": "E1",
                "style": "dark-blue"
            },
            {
                "sheet": "Dashboard",
                "type": "column",
                "data_range": "Data!A1:D4",
                "title": "Monthly Comparison",
                "position": "E15",
                "style": "colorful-2"
            }
        ]
    }
)

Importación y análisis de datos

# Import data from multiple sources
import_result = import_data_tool(
    excel_file="analysis.xlsx",
    import_config={
        "csv": [
            {
                "file_path": "sales_data.csv",
                "sheet_name": "Sales",
                "delimiter": ",",
                "encoding": "utf-8"
            }
        ],
        "json": [
            {
                "file_path": "customer_data.json",
                "sheet_name": "Customers",
                "format": "records"
            }
        ]
    },
    create_tables=True
)

# Filter and analyze the imported data
filtered_data = filter_data_tool(
    file_path="analysis.xlsx",
    sheet_name="Sales",
    table_name="Table_Sales_1",
    filters={
        "Region": ["North", "South"],
        "Sales": {"gt": 10000}
    }
)

🎨 Funciones profesionales

Formato automático

El servidor aplica automáticamente formato profesional:

Ajuste del ancho de columnas según la longitud del contenido
Optimización de la altura de filas para texto ajustado
Esquemas de color profesionales para gráficos y tablas
Estilo coherente en todos los documentos

Estilo de gráficos

Amplias opciones de personalización de gráficos:

Más de 50 estilos predefinidos (temas claros, oscuros y coloridos)
Paletas de colores personalizadas para la coherencia de marca
Diseños profesionales con espaciado adecuado
Múltiples tipos de gráficos: columnas, barras, líneas, circulares, dispersión, áreas

Sistema de plantillas

Crea informes a partir de plantillas:

Plantillas reutilizables para informes coherentes
Sustitución dinámica de datos
Actualización automática de gráficos
Preservación del formato

📋 Requisitos

Node.js 14.0 o superior
Python 3.8 o superior
Sistema operativo: Windows, macOS o Linux

Las dependencias de Python se instalan automáticamente en la primera ejecución:

fastmcp
openpyxl
pandas
numpy
matplotlib
xlsxwriter
xlrd
xlwt

📚 Documentación

Para documentación detallada, consulta:

🤝 Contribuciones

¡Agradecemos las contribuciones! Consulta CONTRIBUTING.md para conocer las directrices.

Configuración de desarrollo

# Clone the repository
git clone https://github.com/guillehr2/Excel-MCP-Server-Master.git
cd Excel-MCP-Server-Master

# Install dependencies
npm install
pip install -r requirements.txt

# Run in development mode
node index.js

🐛 Solución de problemas

Problemas comunes

Python no encontrado: Asegúrate de que Python 3.8+ esté instalado y en tu PATH
Las dependencias no se instalan: Intenta ejecutar con privilegios de administrador
El cliente MCP no reconoce el servidor: Reinicia tu cliente MCP después de la configuración

Para obtener más ayuda, consulta nuestra guía de solución de problemas o abre un issue.

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

🙏 Agradecimientos

Construido con FastMCP
Manipulación de Excel impulsada por openpyxl
Procesamiento de datos con pandas
Publicado en npm para una distribución sencilla
Agradecimiento especial a lwsinclair por la auditoría de seguridad independiente y la integración con MseeP.ai

📊 Estadísticas

GitHub last commit GitHub issues GitHub pull requests npm bundle size

Hecho con ❤️ para el ecosistema MCP

Si encuentras útil este Excel MCP Server, ¡considera darle una ⭐ en GitHub!

Excel MCP Server por Guillem Hermida | GitHub | NPM | Contacto: qtmsuite@gmail.com

Manipulación de Excel sin Microsoft Excel - Servidor de Protocolo de Contexto de Modelo para integración con Claude AI y LLM