Office-Word-MCP-Server
Сервер Model Context Protocol (MCP) для создания, чтения и обработки документов Microsoft Word. Этот сервер позволяет помощникам ИИ работать с документами Word через стандартизированный интерфейс, предоставляя богатые возможности редактирования документов.
Обзор
Office-Word-MCP-Server реализует протокол контекста модели для представления операций с документами Word в качестве инструментов и ресурсов. Он служит мостом между помощниками ИИ и документами Microsoft Word, позволяя создавать документы, добавлять контент, форматировать и анализировать.
Сервер имеет модульную архитектуру, которая разделяет задачи на основные функции, инструменты и утилиты, что делает его легко обслуживаемым и расширяемым для будущих улучшений.
Пример
Пормпт
Выход
Функции
Управление документами
- Создавайте новые документы 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
Использование с Claude для рабочего стола
Конфигурация
Метод 1: После локальной установки
- После установки добавьте сервер в файл конфигурации Claude for Desktop:
{
"mcpServers": {
"word-document-server": {
"command": "python",
"args": ["/path/to/word_mcp_server.py"]
}
}
}
Метод 2: Без установки (с использованием uvx)
- Вы также можете настроить Claude for Desktop для использования сервера без локальной установки с помощью менеджера пакетов uvx:
{
"mcpServers": {
"word-document-server": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}
- Расположение файлов конфигурации:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Перезапустите 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)
Поиск неисправностей
Общие проблемы
- Отсутствующие стили
- В некоторых документах могут отсутствовать необходимые стили для операций с заголовками и таблицами.
- Сервер попытается создать отсутствующие стили или использовать прямое форматирование.
- Для достижения наилучших результатов используйте шаблоны со стандартными стилями Word.
- Проблемы с разрешением
- Убедитесь, что у сервера есть разрешение на чтение/запись путей к документам.
- Используйте функцию
copy_document для создания редактируемых копий заблокированных документов. - Проверьте права собственности на файл и разрешения в случае сбоя операций
- Проблемы со вставкой изображений
- Используйте абсолютные пути для файлов изображений
- Проверьте совместимость формата изображения (рекомендуется JPEG, PNG)
- Проверьте размер файла изображения и разрешения
Отладка
Включите подробное ведение журнала, установив переменную среды:
export MCP_DEBUG=1 # Linux/macOS
set MCP_DEBUG=1 # Windows
Внося вклад
Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.
- Форк репозитория
- Создайте ветку функций (
git checkout -b feature/amazing-feature ) - Зафиксируйте свои изменения (
git commit -m 'Add some amazing feature' ) - Отправить в ветку (
git push origin feature/amazing-feature ) - Открыть запрос на извлечение
Лицензия
Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.
Благодарности
Примечание: Этот сервер взаимодействует с файлами документов в вашей системе. Всегда проверяйте, что запрошенные операции являются подходящими, прежде чем подтверждать их в Claude for Desktop или других клиентах MCP.