word-mcp-live

Единственный MCP-сервер, который редактирует документы Word, пока они открыты

Живое редактирование · Отслеживание изменений · Отмена по действию · 124 инструмента · Кроссплатформенный

word-mcp-live даёт любому ИИ-ассистенту, поддерживающему MCP, полный контроль над Microsoft Word. Откройте документ, скажите ИИ, что вам нужно, и наблюдайте за результатом — форматирование, отслеживание изменений, комментарии и всё остальное. Изменения появляются в реальном времени в вашем открытом документе.

Без word-mcp-live

• ИИ может обсуждать ваш документ, но не может его редактировать

• Вы копируете и вставляете между ИИ и Word, теряя форматирование

• Отслеживание изменений? Вы делаете это вручную после

• Каждое изменение означает сохранить → закрыть → обработать → открыть заново

С word-mcp-live

• «Добавь отслеживаемое изменение, заменив ABC Corp на XYZ Ltd» — готово

• Изменения появляются в реальном времени в вашем открытом документе Word

• Каждое действие ИИ — это один Ctrl+Z

• Настоящие отслеживаемые изменения с вашим именем, а не XML-хаки

Посмотрите в действии

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

Что отличает этот сервер

• Живое редактирование — редактируйте документы, пока они открыты в Word. Без цикла сохранить-закрыть-открыть заново.

• Полная отмена — каждое действие ИИ — это один Ctrl+Z. Ошиблись? Просто отмените.

• Нативное отслеживание изменений — настоящие ревизии Word с вашим именем, а не XML-хаки.

• Ветки комментариев — добавляйте, отвечайте, разрешайте и удаляйте комментарии как человек-рецензент.

• Диагностика макета — обнаруживает проблемы форматирования до того, как они станут катастрофой при печати.

• Уравнения и перекрёстные ссылки — вставляйте математические формулы и автоматически обновляемые ссылки.

• 124 инструмента — самый полный MCP-сервер для Word из доступных.

Related MCP server: Word Document MCP Server

Быстрый старт

pip install word-mcp-live

Или установите из исходников:

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

Установка клиента

Добавьте в ваш claude_desktop_config.json:

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

Добавьте в ваш .mcp.json:

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

В один клик: Нажмите кнопку установки в верхней части этой страницы.

Вручную: Добавьте в ~/.cursor/mcp.json:

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

В один клик: Установить в VS Code

Вручную: Добавьте в ваш settings.json в VS Code:

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

Добавьте в ~/.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"
      }
    }
  }
}

Примечание: режим Docker поддерживает только кроссплатформенные инструменты. Живое редактирование требует нативной установки на Windows.

MCP_AUTHOR задаёт ваше имя для отслеживаемых изменений и комментариев (по умолчанию: "Author"). MCP_AUTHOR_INITIALS задаёт инициалы для комментариев.

Два режима

Оба режима работают вместе. ИИ выбирает подходящий для задачи.

Живое редактирование на macOS (новое в v1.5.0)

Живые инструменты теперь работают на macOS через JavaScript for Automation (JXA). Те же имена инструментов, те же параметры — сервер определяет вашу платформу и использует нужный бэкенд автоматизации.

Конфигурация

Для удалённого развёртывания см. RENDER_DEPLOYMENT.md.

Примеры запросов

Просто скажите ИИ, что вам нужно, на простом языке:

"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"

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

Пример 1: Чтение документа (кроссплатформенно)

Вызов инструмента: get_document_text

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

Ожидаемый вывод:

{
  "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
}

Пример 2: Живое редактирование с отслеживанием изменений (Windows)

Вызов инструмента: word_live_replace_text

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

Ожидаемый вывод:

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

Замены появляются как отслеживаемые изменения в Word с зачёркиванием «ABC Corporation» и подчёркиванием «XYZ Ltd».

Пример 3: Добавление комментария, привязанного к тексту (кроссплатформенно)

Вызов инструмента: 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"
}

Ожидаемый вывод:

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

Комментарий появляется на панели рецензирования в Word, привязанный к указанному тексту.

Справочник инструментов

124 инструмента в двух режимах — см. полный справочник инструментов для подробностей.

Требования

• Python 3.11+

• python-docx, fastmcp, msoffcrypto-tool (устанавливаются автоматически)

• Инструменты Windows Live: Windows 10/11 + Microsoft Word + pywin32 (устанавливается автоматически)

• Инструменты macOS Live: macOS + Microsoft Word для Mac (использует встроенный JXA — дополнительных зависимостей не требуется)

Кроссплатформенные инструменты работают без установленного Word — нужен только python-docx.

Участие в разработке

См. CONTRIBUTING.md для настройки разработки, стиля кода и добавления новых инструментов.

Нашли ошибку? Откройте issue. Есть идея? Запросите функцию.

Благодарности

Создано на основе GongRzhe/Office-Word-MCP-Server от GongRzhe (лицензия MIT).

Дополнительные библиотеки: python-docx · FastMCP · pywin32

Конфиденциальность

Этот сервер работает полностью на вашем локальном компьютере. Никакие данные не собираются, не передаются и не хранятся. См. полную Политику конфиденциальности.

Поддержка

• Сообщения об ошибках: Откройте issue

• Запросы функций: Запросите функцию

• Обсуждения: GitHub Discussions

Лицензия

Лицензия MIT — см. LICENSE для подробностей.

История звёзд