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.

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

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

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

Instalación

Prerrequisitos

Python 3.8 o superior
gestor de paquetes pip

Instalación básica

# Clone the repository
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server

# Install dependencies
pip install -r requirements.txt

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

python setup_mcp.py

Uso con Claude para escritorio

Configuración

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

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

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

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

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

{
  "mcpServers": {
    "word-document-server": {
      "command": "uvx",
      "args": [
        "--from", "office-word-mcp-server", "word_mcp_server"
      ]
    }
  }
}

Ubicaciones de los archivos de configuración:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
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

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)

Adición de contenido

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)

Formato de texto

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)

Formato de tabla

format_table(filename, table_index, has_header_row=None, 
             border_style=None, shading=None)

Solución de problemas

Problemas comunes

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 el formato directo
- Para obtener mejores resultados, utilice plantillas con estilos estándar de Word.
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
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:

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

Contribuyendo

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

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
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.

Office Word MCP Server

Servidor Office Word MCP

Descripción general

Ejemplo

Pormpt

Producción

Características

Gestión de documentos

Creación de contenido

Formato de texto enriquecido

Formato de tabla

Manipulación avanzada de documentos

Instalación

Prerrequisitos

Instalación básica

Uso del script de configuración

Uso con Claude para escritorio

Configuración

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

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

Operaciones de ejemplo

Referencia de API

Creación de documentos y propiedades

Adición de contenido

Formato de texto

Formato de tabla

Solución de problemas

Problemas comunes

Depuración

Contribuyendo

Licencia

Expresiones de gratitud

Tools

Related Resources