Excel MCP Server

Excel MCP Server

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de manipulación de archivos Excel sin requerir la instalación de Microsoft Excel. Este servidor permite la creación de libros de trabajo, manipulación de datos, formato y funciones avanzadas de Excel.

Requisitos

• Python 3.10+
• MCP SDK 1.2.0+
• OpenPyXL 3.1.2+

Componentes

Recursos

El servidor proporciona manipulación de libros de trabajo de Excel a través de OpenPyXL:

• Crea y modifica libros de trabajo de Excel
• Gestiona hojas de cálculo y rangos
• Maneja formato y estilos
• Soporta gráficos y tablas dinámicas

Herramientas

Este servidor proporciona un conjunto completo de herramientas de manipulación de Excel. Para documentación detallada de todas las herramientas disponibles, sus parámetros y ejemplos de uso, consulte TOOLS.md.

Las herramientas incluyen capacidades para:

• Gestión de libros de trabajo y hojas de cálculo
• Lectura y escritura de datos
• Formato y estilos
• Gráficos y visualizaciones
• Tablas dinámicas y análisis de datos

Consulte TOOLS.md para documentación completa.

Características

• Soporte Completo de Excel: Funcionalidad integral de Excel
• Manipulación de Datos: Leer, escribir y transformar datos
• Funciones Avanzadas: Gráficos, tablas dinámicas y formato
• Manejo de Errores: Manejo integral de errores con mensajes claros

Uso

Configuración del Entorno

El servidor se puede configurar usando las siguientes variables de entorno:

• EXCEL_FILES_PATH: Directorio donde se almacenarán los archivos Excel (predeterminado: ./excel_files)

Puede configurarlo de diferentes maneras:

CMD de Windows:

set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server

PowerShell de Windows:

$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server

Linux/MacOS:

export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server

O en la configuración de Claude Desktop:

{
  "mcpServers": {
    "excel": {
      "command": "uv run excel-mcp-server",
      "transport": "sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

Iniciando el Servidor

Inicie el servidor:

uv run excel-mcp-server

El servidor se iniciará en modo SSE y esperará conexiones de clientes MCP.

Conexión en el IDE de Cursor

Después de iniciar el servidor, conéctese al endpoint SSE en el IDE de Cursor:

http://localhost:8000/sse

Las herramientas de Excel MCP estarán disponibles a través del agente.

Para las herramientas disponibles y su uso, consulte TOOLS.md.

Licencia

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