Servidor MCP de procesamiento de documentos de Office

Un servidor MCP (Model Context Protocol) para el procesamiento de documentos de Office, que permite crear y editar documentos de Word, Excel y PowerPoint dentro de clientes MCP sin salir del entorno del asistente de IA.

Descripción general

Office-Editor-MCP implementa el estándar Model Context Protocol para exponer operaciones de documentos de Office como herramientas y recursos. Actúa como puente entre los asistentes de IA y los documentos de Microsoft Office, permitiéndole crear, editar, formatear y analizar diversos documentos de Office a través de asistentes de IA.

Related MCP server: word-doc-mcp

Características

Operaciones con documentos de Word

Gestión de documentos

• Crear nuevos documentos de Word con metadatos (título, autor, etc.)

• Extraer contenido de texto y analizar la estructura del documento

• Ver propiedades y estadísticas del documento

• Listar documentos disponibles en un directorio

• Crear copias de documentos

Creación de contenido

• Añadir encabezados con diferentes niveles

• Insertar párrafos con estilos opcionales

• Crear tablas con datos personalizados

• Añadir imágenes con escalado proporcional

• Insertar saltos de página

Formato de texto

• Formatear secciones concretas de texto (negrita, cursiva, subrayado)

• Cambiar el color del texto y las propiedades de la fuente

• Aplicar estilos personalizados a elementos de texto

• Buscar y reemplazar texto en documentos

Operaciones de Excel

Gestión de libros de trabajo

• Crear nuevos libros de Excel

• Abrir archivos de Excel existentes

• Añadir/eliminar/renombrar hojas de trabajo

Procesamiento de datos

• Leer y escribir el contenido de las celdas

• Insertar/eliminar filas y columnas

• Ordenar y filtrar datos

• Aplicar fórmulas y funciones

Operaciones de PowerPoint

Gestión de presentaciones

• Crear nuevas presentaciones de PowerPoint

• Añadir/eliminar/reordenar diapositivas

• Establecer temas y fondos de diapositiva

Edición de contenido

• Añadir texto y elementos gráficos

• Insertar tablas y gráficos

• Añadir animaciones y transiciones

Características avanzadas

• Reconocimiento OCR (extraer texto de imágenes)

• Comparación de documentos (comparar diferencias entre documentos)

• Traducción de documentos

• Cifrado y descifrado de documentos

• Importación/exportación de datos de tablas (interacción con bases de datos)

Guía de instalación

Requisitos previos

• Python 3.10 o superior

• Gestor de paquetes pip

• Microsoft Office solo es necesario para funciones COM de Windows, como exportación a PDF, animaciones, transiciones y formatos heredados de Office

• Tesseract OCR es necesario cuando se usa ocr_recognize_text

Instalación básica

# Clone the repository
git clone https://github.com/theWDY/office-editor-mcp.git
cd office-editor-mcp

# Install dependencies
pip install -r requirements.txt

El repositorio expone cuatro servidores MCP independientes: word_server.py, excel_server.py, powerpoint_server.py y general_server.py. Configure solo los servidores que necesite. El archivo .cursor/mcp.json incluido contiene un ejemplo completo de cuatro servidores.

Configuración

Configuración en Cursor

Método 1: Configuración mediante la interfaz de usuario

1. Abra Cursor

2. Vaya a Configuración > Funciones > MCP

3. Haga clic en "+ Añadir nuevo servidor MCP"

4. Rellene la información de configuración:

   • Nombre: Office Assistant (modifíquelo como prefiera)

   • Tipo: Seleccione stdio

   • Comando: Introduzca la ruta completa para ejecutar el servidor, por ejemplo:

     python /path/to/office-editor-mcp/word_server.py

     Nota: reemplace esto por su ruta de acceso real

Método 2: Archivo de configuración JSON (recomendado)

1. Cree una carpeta .cursor en el directorio del proyecto (si no existe)

2. Cree un archivo mcp.json en esa carpeta con el siguiente contenido:

{
  "mcpServers": {
    "office-assistant": {
      "command": "python",
      "args": ["/path/to/office-editor-mcp/word_server.py"],
      "env": {"OFFICE_EDIT_PATH": "/path/to/output"}
    }
  }
}

Configuración en Claude Desktop

1. Edite el archivo de configuración de Claude:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Añada la siguiente configuración:

{
  "mcpServers": {
    "office-document-server": {
      "command": "python",
      "args": [
        "/path/to/office-editor-mcp/word_server.py"
      ]
    }
  }
}

3. Reinicie Claude para aplicar la configuración.

Todas las rutas gestionadas por general_server.py deben permanecer dentro de OFFICE_EDIT_PATH. Las operaciones de mover y eliminar están deshabilitadas a menos que OFFICE_ALLOW_DESTRUCTIVE=true esté explícitamente configurado.

Los nuevos archivos cifrados usan un contenedor Fernet con versionado, una sal aleatoria y derivación de contraseña Scrypt. Los archivos cifrados que ya existen siguen siendo legibles y se pueden volver a cifrar para actualizarlos. Las operaciones por lotes están limitadas a 100 archivos y 16 trabajadores por petición.

Ejemplos de uso

Después de la configuración, puede dar directivas a su asistente de IA como estas:

Operaciones con documentos de Word

• "Crear un documento llamado 'quarterly_report.docx' con una portada"

• "Añadir un encabezado y tres párrafos al documento"

• "Insertar una tabla de 4x4 con datos de ventas"

• "Poner en negrita y roja la palabra 'important' en el párrafo 2"

• "Buscar y reemplazar todas las apariciones de 'término antiguo' por 'término nuevo'"

Operaciones de Excel

• "Crear un libro de Excel nuevo llamado 'financial_analysis.xlsx'"

• "Insertar 'Ventas del trimestre' como título en la celda A1"

• "Crear una tabla con datos de ventas de los departamentos y calcular la suma"

• "Crear un gráfico de barras para los datos de ventas"

• "Ordenar los datos de la columna B en orden descending"

Operaciones de PowerPoint

• "Crear una presentación llamada 'project_presentation.pptx'"

• "Añadir una diapositiva nueva con el título 'Resumen del proyecto'"

• "Insertar el logotipo de la empresa en la diapositiva 2"

• "Añadir una animación de entrada al título"

Referencia de la API

Operaciones con documentos de Word

# Document Creation and Properties
create_document(filename, title=None, author=None)
get_document_info(filename)
get_document_text(filename)
get_document_outline(filename)
list_available_documents(directory=".")
copy_document(source_filename, destination_filename=None)

# Content Addition
add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
add_picture(filename, image_path, width=None)
add_page_break(filename)

# Text Formatting
format_text(filename, paragraph_index, start_pos, end_pos, bold=None, 
            italic=None, underline=None, color=None, font_size=None, font_name=None)
search_and_replace(filename, find_text, replace_text)
delete_paragraph(filename, paragraph_index)
create_custom_style(filename, style_name, bold=None, italic=None, 
                    font_size=None, font_name=None, color=None, base_style=None)

Operaciones de Excel

# Workbook Operations
create_workbook(filename)
open_workbook(filename)
save_workbook(filename, new_filename=None)
add_worksheet(filename, sheet_name=None)
list_worksheets(filename)

# Cell Operations
read_cell(filename, sheet_name, cell_reference)
write_cell(filename, sheet_name, cell_reference, value)
format_cell(filename, sheet_name, cell_reference, **format_args)

Operaciones de PowerPoint

# Presentation Operations
create_presentation(filename)
open_presentation(filename)
save_presentation(filename, new_filename=None)
add_slide(filename, layout=None)

Solución de problemas

Problemas comunes

1. Estilos faltantes

   • Es posible que algunos documentos no tengan los estilos necesarios para las operaciones de encabezado y tabla

   • El servidor intenta crear los estilos faltantes o usa formato directo

   • Para obtener mejores resultados, use plantillas con estilos de Office estándar

2. Problemas de permisos

   • Asegúrese de que el servidor tenga permiso de lectura/escritura en las rutas de los documentos

   • Use la función copy_document para crear copias editables de documentos conocidos

   • Si las operaciones fallan, compruebe la propiedad de los archivos y los permisos

3. Problemas al insertar imágenes

   • Use rutas absolutas para los archivos de imagen

   • Verifique la compatibilidad de los formatos de imagen (se recomienda JPEG, PNG)

   • Compruebe el tamaño y los permisos del archivo de imagen

Depuración

Habilite el registro detallado definiendo la variable de entorno:

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

Progreso de implementación

• ✅ Construir el esquema básico del servidor MCP

• ✅ Integración exitosa con asistentes de IA

• ✅ Operaciones básicas con documentos de Word

• ✅ Operaciones básicas con libros de Excel

• ✅ Operaciones básicas con presentaciones de PowerPoint

• ✅ Mejora de características avanzadas

• ✅ Optimización del rendimiento

• ✅ Pruebas de compatibilidad multiplataforma

Contribuciones

¡Las contribuciones son bienvenidas! Siéntase libre de enviar un Pull Request.

1. Haga un fork del repositorio

2. Cree su rama de función (git checkout -b feature/amazing-feature)

3. Haga un commit de sus cambios (git commit -m 'Add some amazing feature')

4. Haga un push de la rama (git push origin feature/amazing-feature)

5. Abra un Pull Request

Licencia

Este proyecto se distribuye bajo la Licencia MIT. Consulte el archivo LICENSE para obtener más detalles.

Agradecimientos

• Model Context Protocol por la especificación del protocolo

• python-docx por el procesamiento de documentos de Word

• openpyxl por el procesamiento de Excel

• python-pptx por el procesamiento de PowerPoint

Nota: Este servidor interactúa con archivos de documento de su sistema. Verifique siempre que las operaciones solicitadas son apropiadas antes de confirmarlas en los asistentes de IA u otros clientes MCP.