flyfish-dev/word-ai

¿Qué hace word-ai?

Servidor MCP, Codex Skill y puente Office.js para edición de Word (DOCX) que preserva la estructura, con licencia AGPL y diseñado para agentes de IA.

Descripción general

flyfish-dev/word-ai permite a los agentes de IA editar archivos de Microsoft Word (.docx) manteniendo la estructura del documento. En lugar de convertir a texto plano (perdiendo formato, tablas y diseños), este proyecto opera directamente sobre el formato DOCX a través de un servidor MCP o un Codex Skill.

Características

• Preservación de estructura: Las tablas, encabezados, listas y estilos se mantienen intactos.
• Múltiples modos de integración:
  • Servidor MCP (Model Context Protocol) para agentes como Claude Code.
  • Codex Skill para plataformas como Cursor o Codex.
  • Puente Office.js para Microsoft Office.
• Licencia AGPL: Código abierto y libre para uso, modificación y distribución.
• Operaciones quirúrgicas: Inserción, modificación y eliminación de contenido sin regenerar el documento completo.

Cómo funciona

El proyecto parsea el archivo DOCX como XML, permitiendo al agente de IA realizar cambios precisos a nivel de nodo. Los comandos se envían a través del MCP o Codex Skill, y el servidor aplica las transformaciones directamente sobre la estructura del documento.

Plataformas soportadas

• Claude Code (vía MCP)
• Cursor (vía Codex Skill)
• Codex (vía Codex Skill)
• Microsoft Office (vía Office.js)

Requisitos

• Node.js 18+
• Acceso a un agente de IA compatible con MCP o Codex Skill
• Archivo .docx existente

Uso rápido

1. Clona el repositorio:

   git clone https://github.com/flyfish-dev/word-ai
   cd word-ai
   

2. Instala las dependencias:

   npm install
   

3. Configura el servidor MCP:

   npm run build
   npm start
   

4. Conecta tu agente (ejemplo con Claude Code):

   claude mcp add word-ai --path /ruta/al/servidor
   

5. Comienza a editar documentos con instrucciones como:
   • "Agrega un párrafo después del título principal"
   • "Actualiza la tabla en la página 3"
   • "Cambia el estilo del encabezado a Título 1"

Ejemplo de uso con Codex Skill

# Ejemplo de integración con el Codex Skill
from codex import use_skill

skill = use_skill("word-ai")
skill.edit(
    file="reporte.docx",
    changes=[
        {"action": "insert_paragraph", "after": "section_2", "text": "Nuevo contenido"},
        {"action": "set_cell", "table": "tabla_datos", "row": 1, "col": 0, "value": "Actualizado"}
    ]
)

Licencia

Este proyecto está licenciado bajo AGPL-3.0. Consulta el archivo LICENSE para más detalles.

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o un pull request en el repositorio de GitHub.