What is Mcp Word

MCP-WORD is a simple CLI server built on Node.js that implements the Model Context Protocol (MCP) for creating and managing Microsoft Word documents in the .docx format.

Use cases

Use cases include automated report generation, creating templates for documents, generating formatted text documents from data sources, and integrating document creation into web applications.

How to use

To use MCP-WORD, clone the repository, install dependencies using npm, and run the server with ‘node server.js’. You can then send JSON commands through standard input to create and manipulate documents.

Key features

Key features include creating and saving documents, adding and formatting text (paragraphs, headings, lists), working with tables (creation, rows, styles, merging cells), inserting images and captions, managing headers and footers, configuring layout (margins, orientation, breaks), and setting document metadata (title, author, subject).

Where to use

MCP-WORD can be used in various fields such as software development for document automation, educational tools for generating reports, and any application requiring dynamic document creation.

MCP-сервер для Microsoft Word (docx)

MCP Word Server — это простой CLI-сервер на Node.js, реализующий Model Context Protocol (MCP) для создания и управления документами Microsoft Word (формат .docx). С помощью JSON-команд, отправленных через стандартный ввод/вывод, можно:

• Создавать и сохранять документы.
• Добавлять и форматировать текст (параграфы, заголовки, списки).
• Работать с таблицами (создание, строки, стили, объединение ячеек).
• Вставлять изображения и подписи.
• Управлять колонтитулами и нумерацией страниц.
• Настраивать разметку (поля, ориентацию, разрывы).
• Задавать метаданные документа (тема, автор, заголовок).

📦 Установка

1. Клонируйте репозиторий:

   git clone https://github.com/<ваш-аккаунт>/mcp-word-server.git
   cd mcp-word-server
   

2. Установите зависимости:

   npm install
   

🚀 Запуск

node server.js

При запуске сервер готов принимать JSON-команды через stdin и ответит JSON-объектом в stdout.

🔧 Конфигурация MCP-клиента

Добавьте в ваш файл cline_mcp_settings.json:

{
  "mcpServers": {
    "word-server": {
      "command": "node",
      "args": [
        "server.js"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": [
        "create_document",
        "add_paragraph",
        "add_heading",
        "add_bullet_list",
        "add_numbered_list",
        "set_alignment",
        "set_font_size",
        "set_font_family",
        "set_spacing",
        "add_table",
        "add_table_row",
        "set_table_style",
        "merge_cells",
        "insert_image",
        "insert_image_with_caption",
        "add_header",
        "add_footer",
        "add_page_numbering",
        "add_page_break",
        "set_margins",
        "set_orientation",
        "set_title",
        "set_author",
        "set_subject",
        "save_document"
      ]
    }
  }
}

📝 Список команд

Все команды принимают объект { command: string, params?: any } и возвращают { command, status, result? | error? }.

1. Создание и сохранение

• create_document — создаёт новый документ. Дополнительно можно передать { title, author, subject }.
• save_document — сохраняет документ в файл. Параметр { path: string }.

2. Работа с текстом

• add_paragraph { text: string }
• add_heading { text: string, level?: number }
• add_bullet_list { items: string[] }
• add_numbered_list { items: string[] }
• set_alignment { alignment: "left"|"center"|"right"|"justify" }
• set_font_size { size: number } (в пунктах)
• set_font_family { name: string }
• set_spacing { before?: number, after?: number, line?: number } или number (межстрочный)

3. Таблицы

• add_table { data?: string[][] }
• add_table_row { cells: string[] }
• set_table_style { style: string }
• merge_cells { startRow, startCol, endRow, endCol }

4. Изображения

• insert_image { path: string, width?: number, height?: number }
• insert_image_with_caption { path: string, caption: string, width?: number, height?: number }

5. Колонтитулы и нумерация

• add_header { text: string }
• add_footer { text: string }
• add_page_numbering {} // добавляет "Стр. X из Y" в footer

6. Разметка

• add_page_break {}
• set_margins { top:number, bottom:number, left:number, right:number } (см или дюймы)
• set_orientation { orientation: "portrait"|"landscape" }

7. Метаданные

• set_title { title: string }
• set_author { author: string }
• set_subject { subject: string }

📋 Примеры использования

Пример взаимодействия через stdin:

🛠️ Разработка и вклад

• Node.js v14+ и npm
• Основная зависимость: docx

Пожалуйста, создавайте issues и pull requests для улучшений и исправлений.

📄 Лицензия

MIT © 2025