doc-tools-mcp

Servidor MCP de herramientas de Word

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de manipulación de documentos de Word basadas en IA. Este servidor implementa el protocolo MCP para que las aplicaciones de IA puedan crear, editar y gestionar documentos de Word mediante interacciones de lenguaje natural.

Características

• Implementación completa del protocolo MCP
• Creación y gestión de documentos de Word
• Manipulación de contenido de texto enriquecido
• Creación y formato de tablas
• Control del diseño del documento
• Gestión de metadatos de documentos
• Monitoreo del estado de los documentos en tiempo real

Prerrequisitos

• Node.js 14 o superior
• Microsoft Word (opcional, para funciones avanzadas)

Instalación

O instalar globalmente:

Para utilizar como dependencia en su proyecto:

Uso

1. Inicie el servidor MCP:

2. El servidor se iniciará en el puerto 8765 de forma predeterminada
3. Configure su aplicación de IA (por ejemplo, Cursor, VSCode) para usar el servidor MCP:
   http://localhost:8765

Herramientas MCP

El servidor proporciona las siguientes funciones MCP:

• create_document - Crea un nuevo documento de Word
  • Parámetros: filePath (obligatorio), título, autor
• open_document - Abre un documento de Word existente
  • Parámetros: filePath (obligatorio)
• add_paragraph - Agrega un párrafo al documento
  • Parámetros: filePath (obligatorio), texto (obligatorio), estilo, alineación
• add_table - Agrega una tabla al documento
  • Parámetros: filePath (obligatorio), filas (obligatorio), columnas (obligatorio), encabezados, datos
• search_and_replace - Buscar y reemplazar texto en el documento
  • Parámetros: filePath (obligatorio), searchText (obligatorio), replaceText (obligatorio), matchCase
• set_page_margins - Establecer los márgenes de página del documento
  • Parámetros: filePath (obligatorio), arriba, derecha, abajo, izquierda
• get_document_info - Obtener metadatos del documento
  • Parámetros: filePath (obligatorio)

Integración con aplicaciones de IA

Cursor

1. Abra el archivo de configuración del cursor ~/.cursor/mcp.json
2. Agregue la siguiente configuración:

O para la versión de desarrollo local:

Después de la configuración, puede utilizar lenguaje natural para manipular documentos de Word:

VSCode y otras herramientas compatibles con MCP

Se aplican pasos de integración similares a otras herramientas compatibles con el protocolo MCP. Consulte la documentación de su herramienta para conocer los pasos específicos de configuración del servidor MCP.

Desarrollo

Para ampliar o modificar este servidor MCP:

1. Clonar el repositorio:

2. Instalar dependencias:

3. Iniciar en modo de desarrollo:

4. Construir para producción:

Agregar nuevas funciones MCP

1. Agregar nuevos métodos en src/services/DocumentService.ts
2. Registrar nuevas funciones en src/mcp-server.ts
3. Actualice las definiciones de tipos según sea necesario

Configuración

• Puerto predeterminado: 8765 (configurable)
• Tipos de archivos admitidos: .docx
• Todas las rutas de archivos deben ser absolutas o relativas al directorio de trabajo actual

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Apoyo

Si encuentra algún problema o tiene sugerencias para mejorar, envíe un problema en nuestro repositorio de GitHub.