Servidor Office Word MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) para crear, leer y manipular documentos de Microsoft Word. Este servidor permite a los asistentes de IA trabajar con documentos de Word a través de una interfaz estandarizada, lo que proporciona amplias funciones de edición de documentos.

Descripción general

Office-Word-MCP-Server implementa el Protocolo de Contexto de Modelo para presentar las operaciones de los documentos de Word como herramientas y recursos. Actúa como puente entre los asistentes de IA y los documentos de Microsoft Word, permitiendo la creación, la adición de contenido, el formato y el análisis de documentos.

El servidor presenta una arquitectura modular que separa las preocupaciones en funcionalidades básicas, herramientas y utilidades, lo que lo hace altamente mantenible y extensible para futuras mejoras.

Ejemplo

Pormpt

Producción

Características

Gestión de documentos

• Crear nuevos documentos de Word con metadatos

• Extraer texto y analizar la estructura del documento

• Ver propiedades y estadísticas del documento

• Listar los documentos disponibles en un directorio

• Crear copias de documentos existentes

• Fusionar varios documentos en un solo documento

• Convertir documentos de Word a formato PDF

Creación de contenido

• Añadir encabezados con diferentes niveles

• Insertar párrafos con estilo opcional

• Crear tablas con datos personalizados

• Agregar imágenes con escala proporcional

• Insertar saltos de página

• Agregar notas al pie y notas finales a los documentos

• Convertir notas al pie en notas finales

• Personalizar el estilo de las notas al pie y las notas finales

Formato de texto enriquecido

• Formatear secciones de texto específicas (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 todos los documentos

Formato de tabla

• Formatear tablas con bordes y estilos

• Crear filas de encabezado con formato distinto

• Aplicar sombreado de celdas y bordes personalizados

• Estructurar tablas para una mejor legibilidad

Manipulación avanzada de documentos

• Eliminar párrafos

• Crear estilos de documentos personalizados

• Aplicar un formato consistente en todos los documentos

• Formatee rangos específicos de texto con control detallado

Protección de documentos

• Añadir protección con contraseña a los documentos

• Implementar edición restringida con secciones editables

• Añadir firmas digitales a los documentos

• Verificar la autenticidad e integridad de los documentos

Instalación

Prerrequisitos

• Python 3.8 o superior

• gestor de paquetes pip

Instalación básica

Uso del script de configuración

Alternativamente, puede utilizar el script de configuración proporcionado que maneja:

• Comprobación de requisitos previos

• Configuración de un entorno virtual

• Instalación de dependencias

• Generando configuración de MCP

Uso con Claude para escritorio

Configuración

Método 1: Después de la instalación local

1. Después de la instalación, agregue el servidor a su archivo de configuración de Claude for Desktop:

Método 2: Sin instalación (usando uvx)

1. También puede configurar Claude for Desktop para usar el servidor sin instalación local mediante el administrador de paquetes uvx:

2. Ubicaciones de los archivos de configuración:

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

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

3. Reinicie Claude for Desktop para cargar la configuración.

Operaciones de ejemplo

Una vez configurado, puedes pedirle a Claude que realice operaciones como:

• "Crear un nuevo documento llamado 'informe.docx' con una página de título"

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

• Insertar una tabla 4x4 con datos de ventas

• "Formatee la palabra 'importante' en el párrafo 2 para que aparezca en negrita y en rojo"

• "Buscar y reemplazar todas las instancias de 'término antiguo' con 'término nuevo'"

• "Crear un estilo personalizado para los encabezados de sección"

• "Aplicar formato a la tabla en mi documento"

Referencia de API

Creación de documentos y propiedades

Adición de contenido

Extracción de contenido

Formato de texto

Formato de tabla

Solución de problemas

Problemas comunes

1. Estilos faltantes

   • Es posible que algunos documentos carezcan de los estilos necesarios para operaciones de encabezado y tabla.

   • El servidor intentará crear los estilos faltantes o utilizar formato directo

   • Para obtener mejores resultados, utilice plantillas con estilos estándar de Word.

2. Problemas de permisos

   • Asegúrese de que el servidor tenga permiso para leer/escribir en las rutas del documento

   • Utilice la función copy_document para crear copias editables de documentos bloqueados

   • Verifique la propiedad y los permisos de los archivos si las operaciones fallan

3. Problemas de inserción de imágenes

   • Utilice rutas absolutas para los archivos de imagen

   • Verificar la compatibilidad del formato de imagen (se recomiendan JPEG y PNG)

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

Depuración

Habilite el registro detallado configurando la variable de entorno:

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

• Protocolo de contexto del modelo para la especificación del protocolo

• python-docx para la manipulación de documentos de Word

• FastMCP para la implementación de MCP de Python

Nota: Este servidor interactúa con los archivos de documentos de su sistema. Verifique siempre que las operaciones solicitadas sean correctas antes de confirmarlas en Claude for Desktop u otros clientes MCP.