Office-Word-MCP-Server

Сервер Model Context Protocol (MCP) для создания, чтения и обработки документов Microsoft Word. Этот сервер позволяет помощникам ИИ работать с документами Word через стандартизированный интерфейс, предоставляя богатые возможности редактирования документов.

Обзор

Office-Word-MCP-Server реализует протокол контекста модели для представления операций с документами Word в качестве инструментов и ресурсов. Он служит мостом между помощниками ИИ и документами Microsoft Word, позволяя создавать документы, добавлять контент, форматировать и анализировать.

Сервер имеет модульную архитектуру, которая разделяет задачи на основные функции, инструменты и утилиты, что делает его легко обслуживаемым и расширяемым для будущих улучшений.

Пример

Пормпт

Выход

Related MCP server: Appwrite MCP Server

Функции

Управление документами

• Создавайте новые документы Word с метаданными

• Извлечение текста и анализ структуры документа

• Просмотр свойств документа и статистики

• Список доступных документов в каталоге

• Создавайте копии существующих документов

• Объединить несколько документов в один документ

• Конвертировать документы Word в формат PDF

Создание контента

• Добавьте заголовки с разными уровнями

• Вставьте абзацы с дополнительным стилем

• Создавайте таблицы с пользовательскими данными

• Добавьте изображения с пропорциональным масштабированием

• Вставить разрывы страниц

• Добавляйте сноски и концевые примечания к документам

• Преобразовать сноски в концевые сноски

• Настройте стиль сносок и концевых сносок

Форматирование расширенного текста

• Форматирование определенных разделов текста (жирный, курсив, подчеркивание)

• Изменить цвет текста и свойства шрифта

• Применение пользовательских стилей к текстовым элементам

• Поиск и замена текста во всех документах

Форматирование таблицы

• Форматирование таблиц с использованием границ и стилей

• Создавайте строки заголовков с особым форматированием

• Применить затенение ячеек и пользовательские границы

• Структурируйте таблицы для лучшей читаемости

Расширенные возможности обработки документов

• Удалить абзацы

• Создавайте собственные стили документов

• Применяйте единообразное форматирование во всех документах.

• Форматируйте определенные диапазоны текста с подробным контролем

Защита документов

• Добавьте защиту паролем к документам

• Реализуйте ограниченное редактирование с помощью редактируемых разделов

• Добавляйте цифровые подписи к документам

• Проверка подлинности и целостности документа

Установка

Установка через Smithery

Чтобы автоматически установить Office Word Document Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @GongRzhe/Office-Word-MCP-Server --client claude

Предпосылки

• Python 3.8 или выше

• менеджер пакетов pip

Базовая установка

# Clone the repository
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server

# Install dependencies
pip install -r requirements.txt

Использование сценария установки

В качестве альтернативы вы можете использовать предоставленный скрипт настройки, который обрабатывает:

• Проверка предварительных условий

• Настройка виртуальной среды

• Установка зависимостей

• Генерация конфигурации MCP

python setup_mcp.py

Использование с Claude для рабочего стола

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

Метод 1: После локальной установки

1. После установки добавьте сервер в файл конфигурации Claude for Desktop:

{
  "mcpServers": {
    "word-document-server": {
      "command": "python",
      "args": ["/path/to/word_mcp_server.py"]
    }
  }
}

Метод 2: Без установки (с использованием uvx)

1. Вы также можете настроить Claude for Desktop для использования сервера без локальной установки с помощью менеджера пакетов uvx:

{
  "mcpServers": {
    "word-document-server": {
      "command": "uvx",
      "args": ["--from", "office-word-mcp-server", "word_mcp_server"]
    }
  }
}

2. Расположение файлов конфигурации:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Перезапустите Claude for Desktop, чтобы загрузить конфигурацию.

Примеры операций

После настройки вы можете попросить Клода выполнить такие операции, как:

• «Создайте новый документ с именем «report.docx» и титульным листом»

• «Добавить заголовок и три абзаца в мой документ»

• «Вставьте таблицу 4x4 с данными о продажах»

• «Слово «важно» в абзаце 2 следует выделить жирным шрифтом и красным цветом»

• «Найти и заменить все вхождения «старого термина» на «новый термин»»

• «Создать собственный стиль для заголовков разделов»

• «Применить форматирование к таблице в моем документе»

Ссылка на API

Создание документа и свойства

create_document(filename, title=None, author=None)
get_document_info(filename)
get_document_text(filename)
get_document_outline(filename)
list_available_documents(directory=".")
copy_document(source_filename, destination_filename=None)
convert_to_pdf(filename, output_filename=None)

Добавление контента

add_heading(filename, text, level=1)
add_paragraph(filename, text, style=None)
add_table(filename, rows, cols, data=None)
add_picture(filename, image_path, width=None)
add_page_break(filename)

Извлечение контента

get_document_text(filename)
get_paragraph_text_from_document(filename, paragraph_index)
find_text_in_document(filename, text_to_find, match_case=True, whole_word=False)

Форматирование текста

format_text(filename, paragraph_index, start_pos, end_pos, bold=None,
            italic=None, underline=None, color=None, font_size=None, font_name=None)
search_and_replace(filename, find_text, replace_text)
delete_paragraph(filename, paragraph_index)
create_custom_style(filename, style_name, bold=None, italic=None,
                    font_size=None, font_name=None, color=None, base_style=None)

Форматирование таблицы

format_table(filename, table_index, has_header_row=None,
             border_style=None, shading=None)

Поиск неисправностей

Общие проблемы

1. Отсутствующие стили

   • В некоторых документах могут отсутствовать необходимые стили для операций с заголовками и таблицами.

   • Сервер попытается создать отсутствующие стили или использовать прямое форматирование.

   • Для достижения наилучших результатов используйте шаблоны со стандартными стилями Word.

2. Проблемы с разрешением

   • Убедитесь, что у сервера есть разрешение на чтение/запись путей к документам.

   • Используйте функцию copy_document для создания редактируемых копий заблокированных документов.

   • Проверьте права собственности на файл и разрешения в случае сбоя операций

3. Проблемы со вставкой изображений

   • Используйте абсолютные пути для файлов изображений

   • Проверьте совместимость формата изображения (рекомендуется JPEG, PNG)

   • Проверьте размер файла изображения и разрешения

Отладка

Включите подробное ведение журнала, установив переменную среды:

export MCP_DEBUG=1  # Linux/macOS
set MCP_DEBUG=1     # Windows

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

1. Форк репозитория

2. Создайте ветку функций ( git checkout -b feature/amazing-feature )

3. Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )

4. Отправить в ветку ( git push origin feature/amazing-feature )

5. Открыть запрос на извлечение

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

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

• Модель контекстного протокола для спецификации протокола

• python-docx для работы с документами Word

• FastMCP для реализации Python MCP

Примечание: Этот сервер взаимодействует с файлами документов в вашей системе. Всегда проверяйте, что запрошенные операции являются подходящими, прежде чем подтверждать их в Claude for Desktop или других клиентах MCP.