doc-tools-mcp

by puchunjie
Verified
MIT License
1,086
1
  • Apple
  • Linux

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides the runtime environment for the MCP server, required as a prerequisite (version 14 or higher)

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

npx @puchunjie/doc-tools-mcp

O instalar globalmente:

npm install -g @puchunjie/doc-tools-mcp

Para utilizar como dependencia en su proyecto:

npm install @puchunjie/doc-tools-mcp

Uso

  1. Inicie el servidor MCP:
npx @puchunjie/doc-tools-mcp
  1. El servidor se iniciará en el puerto 8765 de forma predeterminada
  2. 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:
{ "mcpServers": { "doc-tools-mcp": { "command": "npx", "args": [ "@puchunjie/doc-tools-mcp" ] } } }

O para la versión de desarrollo local:

{ "mcpServers": { "doc-tools-mcp": { "command": "node", "args": [ "/path/to/your/doc-tools-mcp/dist/mcp-server.js" ] } } }

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

"Create a new document named report.docx" "Add a heading 'Monthly Report' to report.docx" "Insert a 4x3 table with sales data"

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:
git clone <repository-url> cd doc-tools-mcp
  1. Instalar dependencias:
npm install
  1. Iniciar en modo de desarrollo:
npm run start
  1. Construir para producción:
npm run build

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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Permita que la IA lea, cree y modifique documentos de Word a través del lenguaje natural

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. MCP Tools
            1. Integration with AI Applications
              1. Cursor
              2. VSCode and Other MCP-Compatible Tools
            2. Development
              1. Adding New MCP Functions
            3. Configuration
              1. License
                1. Support
                  ID: q9e176vq7l