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
- 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
# 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
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_mcp_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)
convert_to_pdf(filename, output_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)
get_document_text(filename)
get_paragraph_text_from_document(filename, paragraph_index)
find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)
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)
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 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
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.