word-mcp-live

El único servidor MCP que edita documentos de Word mientras están abiertos

Edición en vivo · Cambios controlados · Deshacer por acción · 124 herramientas · Multiplataforma

word-mcp-live ofrece a cualquier asistente de IA que admita MCP control total sobre Microsoft Word. Abre un documento, dile a la IA lo que necesitas y observa cómo sucede: formato, cambios controlados, comentarios y todo lo demás. Los cambios aparecen en vivo en tu documento abierto.

Sin word-mcp-live

• La IA puede hablar sobre tu documento pero no puede tocarlo

• Copias y pegas entre la IA y Word, perdiendo el formato

• ¿Cambios controlados? Los haces manualmente después

• Cada edición implica guardar → cerrar → procesar → reabrir

Con word-mcp-live

• «Añade un cambio controlado que reemplace ABC Corp por XYZ Ltd» — hecho

• Los cambios aparecen en vivo en tu documento de Word abierto

• Cada edición de la IA está a un Ctrl+Z de distancia

• Cambios controlados reales con tu nombre, no trucos XML

Míralo en acción

https://github.com/user-attachments/assets/fbb09af4-1e25-4e49-94d0-45b363278810

Qué lo hace diferente

• Edición en vivo — Edita documentos mientras están abiertos en Word. Sin ciclo de guardar-cerrar-reabrir.

• Deshacer completo — Cada acción de la IA es un solo Ctrl+Z. ¿Cometiste un error? Solo deshazlo.

• Cambios controlados nativos — Revisiones reales de Word con tu nombre, no trucos XML.

• Comentarios en hilo — Añade, responde, resuelve y elimina comentarios como un revisor humano.

• Diagnóstico de diseño — Detecta problemas de formato antes de que se conviertan en desastres de impresión.

• Ecuaciones y referencias cruzadas — Inserta fórmulas matemáticas y referencias que se actualizan automáticamente.

• 124 herramientas — El servidor MCP de Word más completo disponible.

Related MCP server: Word Document MCP Server

Inicio rápido

pip install word-mcp-live

O instala desde el código fuente:

git clone https://github.com/ykarapazar/word-mcp-live.git
cd word-mcp-live
pip install -e .

Instalación del cliente

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Añade a tu .mcp.json:

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Con un clic: Haz clic en el botón de instalación en la parte superior de esta página.

Manual: Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Con un clic: Instalar en VS Code

Manual: Añade a tu settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "word": {
        "command": "uvx",
        "args": ["word-mcp-live"],
        "env": {
          "MCP_AUTHOR": "Your Name",
          "MCP_AUTHOR_INITIALS": "YN"
        }
      }
    }
  }
}

Añade a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "word": {
      "command": "uvx",
      "args": ["word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

{
  "mcpServers": {
    "word": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/ykarapazar/word-mcp-live"],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Nota: El modo Docker solo admite herramientas multiplataforma. La edición en vivo requiere una instalación nativa de Windows.

MCP_AUTHOR establece tu nombre en los cambios controlados y comentarios (por defecto: "Author"). MCP_AUTHOR_INITIALS establece las iniciales de los comentarios.

Dos modos

Ambos modos funcionan juntos. La IA elige el adecuado para la tarea.

Edición en vivo en macOS (Nuevo en v1.5.0)

Las herramientas en vivo ahora funcionan en macOS mediante JavaScript for Automation (JXA). Mismos nombres de herramientas, mismos parámetros: el servidor detecta tu plataforma y usa el backend de automatización adecuado.

Configuración

Para despliegue remoto, consulta RENDER_DEPLOYMENT.md.

Ejemplos de indicaciones

Solo dile a la IA lo que quieres en lenguaje natural:

"Draft a contract with tracked changes so my colleague can review"
"Format all headings as Cambria 13pt bold and add automatic numbering"
"Add a comment on paragraph 3 asking about the deadline"
"Find every mention of 'ABC Corp' and replace with 'XYZ Ltd' as a tracked change"
"Set the page to A4 landscape with 2cm margins"
"Insert a table of contents based on the document headings"
"Add page numbers in the footer and our company name in the header"
"Insert a cross-reference to Heading 2 in paragraph 5"

Ejemplos de uso

Ejemplo 1: Leer un documento (multiplataforma)

Llamada a la herramienta: get_document_text

{ "filename": "C:/Documents/report.docx" }

Salida esperada:

{
  "status": "success",
  "paragraphs": [
    {"index": 0, "text": "Quarterly Report", "style": "Heading 1"},
    {"index": 1, "text": "Revenue increased by 15% compared to Q3.", "style": "Normal"},
    {"index": 2, "text": "Key Metrics", "style": "Heading 2"}
  ],
  "total_paragraphs": 3
}

Ejemplo 2: Edición en vivo con cambios controlados (Windows)

Llamada a la herramienta: word_live_replace_text

{
  "filename": "report.docx",
  "find_text": "ABC Corporation",
  "replace_text": "XYZ Ltd",
  "match_case": true,
  "replace_all": true,
  "track_changes": true
}

Salida esperada:

{
  "status": "success",
  "replacements": 4,
  "message": "Replaced 4 occurrences (tracked changes enabled)"
}

Los reemplazos aparecen como cambios controlados en Word con tachado en «ABC Corporation» y subrayado en «XYZ Ltd».

Ejemplo 3: Añadir un comentario anclado a texto (multiplataforma)

Llamada a la herramienta: add_comment

{
  "filename": "C:/Documents/contract.docx",
  "target_text": "payment within 30 days",
  "comment_text": "Should we extend this to 45 days?",
  "author": "Jane Smith"
}

Salida esperada:

{
  "status": "success",
  "message": "Comment added by Jane Smith on 'payment within 30 days'"
}

El comentario aparece en el panel de Revisión de Word, anclado al texto especificado.

Referencia de herramientas

124 herramientas en dos modos: consulta la referencia completa de herramientas para más detalles.

Requisitos

• Python 3.11+

• python-docx, fastmcp, msoffcrypto-tool (instalados automáticamente)

• Herramientas en vivo de Windows: Windows 10/11 + Microsoft Word + pywin32 (instalado automáticamente)

• Herramientas en vivo de macOS: macOS + Microsoft Word para Mac (usa JXA integrado: sin dependencias adicionales)

Las herramientas multiplataforma funcionan sin Word instalado: solo se necesita python-docx.

Contribuciones

Consulta CONTRIBUTING.md para la configuración de desarrollo, el estilo de código y cómo añadir nuevas herramientas.

¿Encontraste un error? Abre un issue. ¿Tienes una idea? Solicita una función.

Agradecimientos

Construido sobre GongRzhe/Office-Word-MCP-Server por GongRzhe (Licencia MIT).

Bibliotecas adicionales: python-docx · FastMCP · pywin32

Privacidad

Este servidor se ejecuta completamente en tu máquina local. No se recopilan, transmiten ni almacenan datos. Consulta la Política de privacidad completa.

Soporte

• Informes de errores: Abre un issue

• Solicitudes de funciones: Solicita una función

• Discusiones: GitHub Discussions

Licencia

Licencia MIT: consulta LICENSE para más detalles.

Historial de estrellas