KitchenSink4Word

🚰 KitchenSink4Word

Página de inicio · llms.txt (manifiesto de capacidades legible por máquina para agentes y rastreadores de LLM)

Todo, y hasta el fregadero de la cocina, para Microsoft Word. El servidor MCP de Word (.docx) más completo disponible: 189 herramientas, diseñado para no corromper archivos, probado a fondo con documentos reales largos y muy formateados. Ahora con edición en vivo: los documentos abiertos en Word se editan en el lugar, de forma visible, y cada llamada de herramienta se registra como un solo paso de Ctrl+Z.

La historia de origen: un agente de IA necesitó quince minutos para editar veinte celdas de tabla en un documento de Word, porque ningún MCP de Word existente podía eliminar una columna de tabla, editar celdas en bloque, gestionar notas al pie Y insertar una tabla de contenido. Así que, en lugar de instalar tres servidores mediocres, se construyó este. Se prototipó en un día y luego se endureció hasta que los agentes de prueba adversariales se quedaron sin quejas. Tus agentes no tendrán ese problema.

Por qué este (la comparación honesta)

Se encuestó cada servidor MCP de Word público antes de construir este (agosto de 2026):

Capacidad	KitchenSink4Word	GongRzhe Office-Word (2.1k★, archivado)	word-mcp-live (195★)	SecurityRonin docx-mcp (43★)
Edición en vivo mientras el documento está abierto en Word	✅ seguro para el cursor, un Ctrl+Z por llamada	❌	✅	❌
Insertar/eliminar columnas de tabla	✅ consciente de fusiones	❌	❌	❌
Ediciones de celdas en bloque (una llamada)	✅	❌	❌	❌
Fusionar/dividir celdas	✅	solo fusionar	❌	❌
CRUD de notas al pie Y notas finales	✅ + conversión	solo agregar	❌	✅
Insertar y actualizar tabla de contenido	✅	❌	❌	❌
Citas/bibliografía nativas	✅ 12 estilos	❌	❌	❌
Generación de índice	✅	❌	❌	❌
ESCRITURA de cambios controlados	✅	❌	✅	✅
Aceptar/rechazar por autor	✅	❌	parcial	✅
Comparar y combinar documentos	✅ nativo de Word	❌	❌	con errores
Marcas de agua / protección / números de línea	✅	solo protección	❌	❌
Mover secciones / transferir plantillas	✅	❌	❌	❌
Guardados atómicos + copia de seguridad automática	✅	❌	❌	❌

189 herramientas que abarcan: ecuaciones (LaTeX → matemáticas de Word), gráficos nativos, ensamblaje de documentos (archivos de capítulos en un solo manuscrito), citas de biblioteca Zotero, conversión de estilos de publicación (8 estilos, beta), análisis de ciclo de revisión, suites de flujo de trabajo (combinación de correspondencia, operaciones por lotes, redacción, auditorías y correcciones de cumplimiento/accesibilidad, preparación de envíos, material preliminar, diagnósticos), texto y formato, tablas (incluida la inserción/eliminación de columnas consciente de fusiones y ediciones de celdas en bloque en una llamada), notas al pie/notas finales (CRUD completo + conversión de nota al pie↔nota final), tabla de contenido y listas de títulos, encabezados/pies de página/secciones, imágenes, listas con viñetas/numeradas, controles de contenido y campos, comentarios enhebrados, cambios controlados (lectura, aceptar/rechazar por autor, Y escritura de ediciones como cambios controlados), además de comparación de documentos respaldada por Word-COM, actualización de campos, exportación/importación de PDF y validación de apertura limpia en Windows.

Novedades en v1.6 (2026-08-28)

19 nuevas herramientas más expansión del modo en vivo, construidas mientras el servidor editaba una disertación real en producción:

• Gráficos nativos: add_chart (barras/columnas/líneas/circular/dispersión a partir de datos en línea o CSV/JSON; la parte del gráfico lleva cachés de datos literales Y un libro de trabajo incrustado coincidente, por lo que clic derecho > Editar datos funciona en Word), update_chart_data, list_charts.
• Ensamblaje de documentos: insert_document inserta el cuerpo completo de un documento en otro en una posición elegida con reconciliación completa (estilos por nombre, numeración, notas al pie/notas finales, marcadores, imágenes, gráficos) y modos de pegado estilo Word (origen/combinar/destino); copy_table trasplanta una sola tabla con la misma maquinaria.
• Rediseño de copia de seguridad: esquema acotado de dos ranuras en una carpeta oculta .ks4w-backups/ (prev = antes de la última mutación, anchor = inicio de sesión) reemplaza la proliferación de .bak por edición; manage_backups lista, restaura (de forma deshacible) y purga, incluida la limpieza de .bak heredados; create_snapshot crea copias permanentes con marca de fecha y hora. Las escrituras en el mismo archivo se serializan dentro del proceso y entre procesos de servidor.
• Aislamiento de rutas (opt-in, KS4W_ALLOWED_ROOTS): consulte Aislamiento a continuación.
• Correcciones de accesibilidad: fix_accessibility repara hallazgos de auditoría una categoría opt-in a la vez (marcadores de texto alternativo señalados para revisión humana, reparación de saltos de encabezado, filas de encabezado de tabla, título del documento), junto con audit_accessibility.
• Análisis forense y reparación de estilos: replace_formatted (el gemelo de mutación de find_formatted), get_paragraph_format (formato efectivo con la fuente de herencia por propiedad), outline_level en set_paragraph_format más get_outline consciente de outlineLvl (plantillas académicas que construyen encabezados desde Normal + anulaciones de esquema), y change_heading_level (promover/rebajar con subárbol).
• Campos, controles, glosario: insert_field/list_fields genéricos (códigos seguros en lista blanca), insert_content_control / list_content_controls / set_content_control_value, insert_glossary construido a partir de términos definidos detectados.
• Orientación de flujo de trabajo: get_workflows mapea tareas comunes a secuencias de herramientas recomendadas; detect_citation_system advierte antes de mezclas de citas Word-nativas/Zotero/Mendeley/EndNote.
• Expansión del modo en vivo: word_count (el propio motor de estadísticas de Word), get_comments, replace_paragraph_text, format_text (con etiquetado de idioma CJK) ganaron rutas en vivo; las respuestas en vivo y de archivo ahora comparten una sola forma; las búsquedas en vivo más allá del límite de ~255 caracteres de Word se manejan; la indexación de documentos vacíos y la carrera de archivos paralelos se corrigen.

Flujo de trabajo recomendado para edición intensiva

El patrón que las pruebas establecieron para sesiones largas: mantenga su copia del documento abierta en Word para lectura, apunte al agente a una copia nueva con marca de fecha y hora (copy_document o create_snapshot) donde tenga el conjunto completo de herramientas de modo archivo, y abra el resultado cuando termine. Usted lee sin interrupciones, el agente edita a toda velocidad con todas las herramientas disponibles, y cada estado intermedio permanece recuperable (copias de seguridad de ranura más su original intacto). El modo en vivo brilla para ediciones interactivas de ver-cómo-sucede; la reestructuración masiva pertenece a una copia.

Novedades en v1.4 (2026-08-28)

El nivel de flujo de trabajo: 24 nuevas herramientas que convierten primitivas de documento en trabajos completos:

• Producción de documentos: mail_merge (plantilla + CSV/JSON → un documento por fila, rechazo atómico de colisiones), fill_template ({{placeholders}} y MERGEFIELDs, seguro en ejecuciones fragmentadas), batch_apply (las mismas ediciones en docenas de archivos, todo-o-nada por archivo), herramientas de campos de formulario (campos de formulario heredados Y controles de contenido: listar, completar, validar integridad).
• Verificaciones previas al vuelo: check_template_compliance (validar márgenes, fuentes, espaciado, estructura de encabezados, numeración de páginas y secciones requeridas contra un conjunto de reglas que usted escribe desde cualquier guía de formato), check_brand_compliance, audit_accessibility (jerarquía de encabezados, texto alternativo, encabezados de tabla, contraste, texto de enlaces), check_image_resolution (DPI efectivo vs. un umbral de impresión), validate_cross_references (objetivos REF/PAGEREF rotos más referencias de texto "ver Figura 3" que no coinciden con nada), validate_captions, check_defined_terms (borradores legales: definido-pero-no-usado, usado-pero-no-definido, definido-dos-veces, usado-antes-de-definido).
• Movimientos finales: prepare_for_submission (aceptar todas las revisiones y eliminar comentarios y metadatos de identificación en una llamada idempotente; el contenido en sí permanece intacto), redact_text (eliminación VERDADERA de texto, tablas, encabezados, notas al pie, comentarios, propiedades, hipervínculos, códigos de campo y eliminaciones controladas, con un re-escaneo de verificación y una lista explícita de lo que NO se examinó), assemble_front_matter (portada hasta tabla de contenido con cambio de numeración romana/arábiga en una llamada), setup_chapter_headers (encabezados de capítulo mediante STYLEREF), diagnose_document (13 verificaciones de salud estructural que nunca fallan en un archivo roto), com_import_pdf (PDF → .docx editable mediante el propio convertidor de Word), inventario de campos de gestor de referencias + verificación de integridad (Zotero, EndNote, Mendeley).

Novedades en v1.3 (2026-08-28)

Edición en vivo. Un documento abierto en Word ya no tiene que cerrarse primero. Las herramientas de alto valor se enrutan automáticamente a una capa COM en vivo cuando el archivo está bloqueado (o explícitamente con live="force"; live="off" restaura el rechazo anterior):

• Las ediciones aparecen en la ventana de Word inmediatamente; nada toca el disco hasta que el USUARIO guarda (o se llama a una herramienta de guardado explícito). El trabajo no guardado nunca se auto-guarda ni se auto-cierra.
• Una llamada de herramienta = un paso de Ctrl+Z. Cada llamada mutante se envuelve en un registro de deshacer personalizado, por lo que un reemplazo masivo de 40 coincidencias se revierte con un solo deshacer.
• El cursor es sagrado. Todo el direccionamiento se basa en Rangos; la selección del usuario, la posición de desplazamiento y la vista nunca se tocan. (Una excepción deliberada: live_scroll_to trae una ubicación a la vista a petición, sin seleccionarla).
• Herramientas enrutadas: search_and_replace, insert_paragraphs, delete_paragraphs, set_cells, format_text, get_text, find_text, get_outline, get_document_info. Herramientas solo en vivo: live_insert_at_cursor, live_scroll_to, live_set_track_changes, word_live_repair (recuperación si un cliente bloqueado dejó Word en mal estado).
• Informe de estado honesto en cada resultado en vivo: documento sucio, estado de AutoSave, solo lectura, control forzado bajo protección y recuentos de omisión por elemento cuando las coincidencias están dentro de resultados de campos (Word los regenera, por lo que editarlos se rechaza en lugar de fingirse).
• Los documentos restringidos por protección reciben rechazos tipificados por adelantado; los documentos en Vista protegida se nombran como tales.
• Los códigos de campo de gestor de referencias (Zotero y similares) sobreviven a ediciones en vivo y basadas en archivos a su alrededor, verificado por pruebas dedicadas.

Novedades en v1.2 (2026-08-28)

• Citas y bibliografía nativas de Word: almacén de fuentes estructurado, campos CITATION con interruptores de página/suprimir, campo BIBLIOGRAPHY, 12 estilos seleccionables (APA, Chicago, MLA, IEEE, ...), verificado de extremo a extremo: Word renderiza los campos en el estilo seleccionado.
• Índice (entradas XE con anidamiento y referencias cruzadas + campo INDEX) y listas de títulos (Lista de Tablas/Figuras).
• Kit de diseño de documentos largos: formatos de página en números romanos, numeración de líneas, marcas de agua (compatibles con Quitar marca de agua de Word), secciones de múltiples columnas, Página X de Y.
• Protección de documentos con hash de contraseña SHA-512 compatible con Word (verificado byte por byte contra la salida de Word); el modo trackedChanges obliga a que las ediciones de los destinatarios se controlen.
• Operaciones de estructura: move_section (un encabezado más toda su sección, tablas incluidas), transferencia de plantilla (reestilizar para coincidir con un documento de referencia con reasignación de estilos por nombre), estilos personalizados, estilos de carácter, propiedades de documento, texto alternativo de imágenes.
• Completaciones de tablas: filas gridBefore/gridAfter, estilos de tabla con nombre, ordenar, dividir, repetir fila de encabezado, lectura/escritura de tablas anidadas, dirección de texto de celda.
• Cola larga de formato: versalitas, texto oculto, espaciado de caracteres, kerning, etiquetado de idioma CJK, paradas de tabulación con líderes, bordes/sombreado de párrafo, control de viudas, cambio de mayúsculas.
• Análisis: recuentos de palabras por sección, verificación de paridad de citas APA, errores de revisión y estadísticas de legibilidad de Word, fusión de capítulos, combinación de revisores, guardado cifrado con contraseña.

Qué lo hace diferente

• Operaciones de columnas de tabla conscientes de fusiones. delete_columns / insert_columns funcionan correctamente a través de celdas fusionadas horizontal y verticalmente (gridSpan se reduce, las cadenas vMerge se re-enraízan). Al momento de escribir esto, ningún otro MCP público de Word tiene esto.
• API de primer lote. Editar 20 celdas es UNA llamada set_cells con una carga útil, no 20 idas y vueltas.
• Escritura de cambios rastreados. track=True, author="Jane" en herramientas de reemplazo/inserción/ eliminación/celdas produce revisiones reales de Word que el destinatario puede aceptar/rechazar, probadas de ida y vuelta contra el propio motor de revisión del servidor.
• Comparación de documentos. com_compare_documents produce un redline nativo de Word entre dos versiones de un documento.
• Nunca corrompe. Guardados atómicos (archivo temporal → validación estructural → reemplazo), copias de seguridad automáticas en ranuras antes de cada mutación, paso directo byte-idéntico de cualquier cosa que no se esté editando (ecuaciones, cuadros de texto, controles de contenido sobreviven intactos), y errores tipados limpios: un archivo abierto en Word se rechaza con un mensaje, no con un cuelgue.
• Seguro con ejecuciones fragmentadas. Buscar/reemplazar funciona a través de las ejecuciones arbitrariamente divididas de Word mientras preserva el formato por carácter, con un guardia de tiempo de espera ReDoS en expresiones regulares de usuario y un límite opcional de radio de explosión max_replacements.

Requisitos

• Windows (las herramientas COM requieren Microsoft Word instalado; todas las demás herramientas son manipulación pura de archivos y funcionan sin Word)
• Python 3.12+ (desarrollado en 3.14)

Instalación

Dos minutos, de inicio a edición:

pip install kitchensink4word
claude mcp add word -s user -- kitchensink4word

Claude Desktop con un clic: descargue kitchensink4word.mcpb de la última versión, luego en Desktop use Configuración > Extensiones > Configuración avanzada > Instalar extensión y elija el archivo. Requiere uv en su PATH (pip install uv), que el paquete usa para lanzar el servidor.

Para otros clientes MCP, apunte el comando del servidor al ejecutable kitchensink4word (o word-mcp) instalado:

{"mcpServers": {"word": {"command": "kitchensink4word"}}}

Desde el código fuente en su lugar:

git clone https://github.com/nometalalchemist/KitchenSink4Word
cd KitchenSink4Word
python -m venv .venv
.venv\Scripts\pip install -e .
claude mcp add word -s user -- <absolute-path>\.venv\Scripts\word-mcp.exe

Modelo de seguridad

• Cada herramienta mutadora toma file_path y rota el contenido actual a ranuras de respaldo estables antes del cambio (backup=False para omitir la rotación; el guardado atómico validado siempre se aplica). Los respaldos viven en una carpeta oculta .ks4w-backups/ junto al documento, una subcarpeta por documento, con exactamente dos ranuras: prev.docx (estado antes de la mutación más reciente) y anchor.docx (inicio de sesión, rotando después de 60+ minutos de inactividad). El almacenamiento se mantiene acotado a aproximadamente dos copias por documento sin importar cuántas ediciones haga una sesión. manage_backups lista, restaura (de forma deshacible: el estado previo a la restauración rota a prev primero), y purga, incluyendo archivos *.bak-* sobrantes del esquema anterior a v1.6.
• Excluya .ks4w-backups/ de herramientas de sincronización en la nube (OneDrive, Dropbox, Google Drive): las ranuras cambian en cada edición y los clientes de sincronización pueden mantener bloqueos que ralentizan los guardados.
• Las mutaciones del mismo archivo se serializan (en proceso y entre procesos del servidor mediante un archivo de bloqueo de asesoría), por lo que las llamadas paralelas no pueden pisarse entre sí y los metadatos de respuesta reflejan el estado documental asentado.
• Las mutaciones COM/en vivo (documentos abiertos en Word) permanecen fuera de este sistema de respaldo; la Recuperación automática de Word cubre el documento abierto.
• Los guardados son atómicos y validados; una operación fallida deja el original byte-idéntico.
• Eliminar contenido que lleva referencias de notas al pie elimina automáticamente las definiciones ahora huérfanas; validate_document / validate_notes informan integridad en ambas direcciones.
• La eliminación de párrafos rechaza rangos que cortarían un campo (TOC, PAGEREF) por la mitad o tragarían silenciosamente un salto de sección.

Aislamiento (opt-in)

Desactivado por defecto: sin nada configurado, el servidor se comporta exactamente como siempre. Establezca la variable de entorno KS4W_ALLOWED_ROOTS a una lista de directorios separados por el separador de rutas del sistema operativo (; en Windows, : en otros lugares), por ejemplo C:\Users\me\Documents;D:\Work, y cada ruta que el servidor toque debe resolverse dentro de uno de esos directorios. Las lecturas también están restringidas, así como las escrituras, ya que una lectura fuera del aislamiento exfiltra contenido tan seguramente como una escritura lo planta. La verificación de contención se ejecuta en rutas canonizadas, por lo que la travesía ..\, escapes de enlaces simbólicos y junctions, nombres cortos 8.3, prefijos de longitud extendida, trucos de mayúsculas/minúsculas y directorios hermanos similares (Documents2 contra un Documents permitido) se detectan todos, y las rutas de red UNC se rechazan a menos que una raíz permitida sea en sí misma una ruta UNC que las contenga. Una llamada bloqueada se rechaza con un error tipado que nombra la ruta infractora y las raíces permitidas antes de que se abra cualquier archivo. Recomendado siempre que el servidor se ejecute contra tráfico de agentes no confiable o semiconfiable.

Pruebas

910 pruebas (852 se ejecutan en todas partes; 58 pruebas marcadas como en vivo manejan una instancia real de Word en Windows): la suite se desarrolló contra un corpus privado de documentos del mundo real (capítulos de longitud de libro, un documento con 171 notas al pie, un manuscrito con 126 cambios rastreados y comentarios de revisores), y el CI genera automáticamente sustitutos sintéticos estructuralmente equivalentes (tests/make_corpus.py) para que la suite completa se ejecute en cualquier máquina, incluida la suya y cada solicitud de extracción. Los documentos reales locales, cuando están presentes, tienen prioridad. tests/word_validator.py abre las salidas en Word invisible y falla en cualquier aviso de reparación, la verificación definitiva de corrupción.

Historial de desarrollo: prototipado con Claude Code en un día (2026-08-27), luego endurecido a lo largo de tres ciclos de lanzamiento a través de seis rondas adversariales dedicadas: aproximadamente 3,200 llamadas crudas a través del transporte stdio de MCP (tortura de escala, topologías de fusión patológicas, fuzzing Unicode/esquema, ReDoS, ciclo de vida de bloqueo de Word, cacerías de interacción de edición en vivo, verificaciones de fugas COM) más puertas unitarias por fase. Cada hallazgo se corrigió con una prueba de regresión, en la misma sesión en que se encontró. research/ documenta los algoritmos OOXML y los escollos sobre los que se construye la implementación, con atribución a las implementaciones de referencia con licencia MIT estudiadas.

Madurez: qué el número de versión afirma y qué no

Este proyecto avanza rápido y es honesto sobre lo que lo respalda. Lo que cubre el registro de pruebas: cada lanzamiento pasa la suite completa (910 pruebas) más rondas adversariales dedicadas a través del transporte MCP crudo (~2,500 llamadas hasta la fecha), contra un corpus de documentos largos y muy formateados del mundo real con cero corrupción en todo ello. Lo que aún no cubre: otras máquinas, versiones de Word más antiguas que el Microsoft 365 actual, instalaciones de Word no inglesas (algunas herramientas referencian estilos por nombre de visualización localizado), scripts RTL y la diversidad de documentos que solo los usuarios reales traen. La red de seguridad mientras la herramienta gana ese kilometraje es estructural: respaldos automáticos en ranuras antes de cada mutación y guardados atómicos validados, por lo que un mal resultado es una restauración, no una pérdida. Si algo se comporta mal en sus documentos, un problema con el síntoma (nunca el documento en sí, a menos que no contenga nada privado) es lo más valioso que puede enviar.

Herramientas etiquetadas como Beta, heurísticas por naturaleza: revise su lista de elementos marcados en lugar de confiar silenciosamente: convert_citation_style, anonymize_for_review, check_defined_terms y el escaneo de referencias de texto dentro de validate_cross_references. Cada una devuelve una lista explícita de lo que no pudo manejar con confianza.

Limitaciones conocidas

• Los reemplazos de expresiones regulares en vivo omiten coincidencias posicionadas después de campos complejos en una historia (los desplazamientos de caracteres COM se desvían allí); el recuento de omisiones se informa y una búsqueda literal aún funciona. set_cells en vivo rechaza tablas fusionadas verticalmente (la herramienta basada en archivos es consciente de fusiones; cierre el documento para esas).
• La atribución de cambios rastreados en vivo es de mejor esfuerzo: Word conectado a una cuenta de Office atribuye revisiones a esa cuenta; los resultados informan el autor efectivo honestamente.
• Los números de página de TOC/listas de títulos requieren una actualización de campo: automática en la próxima apertura de Word (update_on_open), o inmediata mediante com_refresh_fields.

Licencia

AGPL-3.0: gratis para cualquier uso bajo los términos de AGPL (copyleft: las modificaciones a copias servidas deben ser de código abierto). Licencia comercial disponible para casos de uso que no puedan cumplir; abra un problema para arreglar una.