Servidor Excel MCP
Un servidor MCP que proporciona capacidades integrales de gestión de archivos Excel y análisis de datos.
Características
- Operaciones con archivos de Excel
- Leer múltiples formatos de Excel (XLSX, XLS, CSV, TSV, JSON)
- Escribir y actualizar archivos de Excel
- Obtener información de archivos y nombres de hojas
- Análisis de datos
- Estadísticas de resumen y análisis descriptivo
- Evaluación de la calidad de los datos
- Tablas dinámicas
- Filtrado y consulta de datos
- Visualización
- Generar gráficos y diagramas a partir de datos de Excel
- Crear vistas previas de datos
- Exportar visualizaciones como imágenes
Instalación
- Crear un nuevo entorno de Python (recomendado):
# Using uv (recommended)
uv init excel-mcp-server
cd excel-mcp-server
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Or using pip
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
- Instalar dependencias:
# Using uv
uv pip install -r requirements.txt
# Or using pip
pip install -r requirements.txt
Integración con Claude Desktop
- Instalar Claude Desktop
- Abra Configuración y vaya a la pestaña Desarrollador
- Editar
claude_desktop_config.json
:
{
"mcpServers": {
"command": "uvx",
"args": [
"mcp-excel-server"
],
"env": {
"PYTHONPATH": "/path/to/your/python"
}
}
}
Herramientas disponibles
Lectura de archivos
read_excel
: Leer archivos de Excelget_excel_info
: Obtener detalles del archivoget_sheet_names
: Lista los nombres de las hojas de trabajo
Análisis de datos
analyze_excel
: Realizar análisis estadísticofilter_excel
: Filtrar datos por condicionespivot_table
: Crea tablas dinámicasdata_summary
: Generar un resumen de datos completo
Visualización de datos
export_chart
: Generar gráficos- Admite gráficos de líneas, gráficos de barras, gráficos de dispersión e histogramas.
Operaciones con archivos
write_excel
: Escribe nuevos archivos de Excelupdate_excel
: Actualizar archivos de Excel existentes
Recursos disponibles
excel://{file_path}
: Obtener el contenido del archivoexcel://{file_path}/info
: Obtener información de la estructura del archivoexcel://{file_path}/preview
: Generar imagen de vista previa de datos
Plantillas de indicaciones
analyze_excel_data
: Plantilla guiada para el análisis de datos de Excelcreate_chart
: Ayuda a crear visualizaciones de datosdata_cleaning
: Ayuda con la limpieza de datos
Ejemplos de uso
- Analizar mi archivo sales_data.xlsx
- "Crear un gráfico de barras para product_sales.csv"
- Filtrar empleados mayores de 30 años en empleados.xlsx
- Generar una tabla dinámica de ventas por departamento
Consideraciones de seguridad
- Leer archivos sólo desde rutas especificadas
- Limitar el tamaño del archivo
- Evitar la sobrescritura accidental de archivos
- Controlar estrictamente las operaciones de transformación de datos
Dependencias
- pandas
- Numpy
- matplotlib
- nacido en el mar
Licencia
Licencia MIT