Excel

Manipulación de Excel que incluye lectura/escritura de datos, gestión de hojas de cálculo, formato, gráficos y tablas dinámicas.

Documentación

Excel MCP Server Logo

PyPI version Total Downloads License: MIT smithery badge Install MCP Server

Un servidor de Model Context Protocol (MCP) que te permite manipular archivos de Excel sin necesidad de tener Microsoft Excel instalado. Crea, lee y modifica libros de Excel con tu agente de IA.

Características

  • 📊 Operaciones de Excel: Crea, lee y actualiza libros y hojas de cálculo
  • 📈 Manipulación de datos: Fórmulas, formato, gráficos, tablas dinámicas y tablas de Excel
  • 🔍 Validación de datos: Validación integrada para rangos, fórmulas e integridad de datos
  • 🎨 Formato: Estilos de fuente, colores, bordes, alineación y formato condicional
  • 📋 Operaciones con tablas: Crea y administra tablas de Excel con estilos personalizados
  • 📊 Creación de gráficos: Genera varios tipos de gráficos (líneas, barras, circulares, dispersión, etc.)
  • 🔄 Tablas dinámicas: Crea tablas dinámicas para análisis de datos
  • 🔧 Gestión de hojas: Copia, renombra y elimina hojas de cálculo con facilidad
  • 🔌 Soporte de triple transporte: stdio, SSE (obsoleto) y HTTP transmisible
  • 🌐 Remoto y local: Funciona tanto localmente como como servicio remoto

Uso

El servidor admite tres métodos de transporte:

1. Transporte Stdio (para uso local)

uvx excel-mcp-server stdio
{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. Transporte SSE (Eventos enviados por el servidor - Obsoleto)

uvx excel-mcp-server sse

Conexión de transporte SSE:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. Transporte HTTP transmisible (Recomendado para conexiones remotas)

uvx excel-mcp-server streamable-http

Conexión de transporte HTTP transmisible:

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

Variables de entorno y manejo de rutas de archivos

Transportes SSE y HTTP transmisible

Cuando se ejecuta el servidor con los protocolos SSE o HTTP transmisible, debe establecer la variable de entorno EXCEL_FILES_PATH en el lado del servidor. Esta variable le indica al servidor dónde leer y escribir archivos de Excel.

  • Si no se establece, por defecto es ./excel_files.
  • Con estos transportes, los valores de la herramienta filepath deben ser relativos a ese directorio (por ejemplo, reports/q1.xlsx); las rutas absolutas y el recorrido de directorios se rechazan.

También puede establecer la variable de entorno FASTMCP_PORT para controlar el puerto en el que el servidor escucha (por defecto es 8017 si no se establece).

  • Ejemplo (Windows PowerShell):
    $env:EXCEL_FILES_PATH="E:\MyExcelFiles"
    $env:FASTMCP_PORT="8007"
    uvx excel-mcp-server streamable-http
    
  • Ejemplo (Linux/macOS):
    EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http
    

Transporte Stdio

Cuando se utiliza el protocolo stdio, la ruta del archivo se proporciona con cada llamada a la herramienta, por lo que no es necesario establecer EXCEL_FILES_PATH en el servidor. El servidor utilizará la ruta enviada por el cliente para cada operación.

Herramientas disponibles

El servidor proporciona un conjunto completo de herramientas de manipulación de Excel. Consulta TOOLS.md para obtener la documentación completa de todas las herramientas disponibles.

Historial de estrellas

Star History Chart

Licencia

Licencia MIT - consulta LICENSE para más detalles.