doc-tools-mcp

Сервер MCP Word Tools

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

Функции

• Полная реализация протокола MCP
• Создание и управление документами Word
• Манипулирование содержимым расширенного текста
• Создание и форматирование таблиц
• Контроль макета документа
• Управление метаданными документа
• Мониторинг состояния документа в режиме реального времени

Предпосылки

• Node.js 14 или выше
• Microsoft Word (опционально, для расширенных функций)

Установка

Или установите глобально:

Для использования в качестве зависимости в вашем проекте:

Использование

1. Запустите MCP-сервер:

2. По умолчанию сервер будет запущен на порту 8765.
3. Настройте свое приложение ИИ (например, Cursor, VSCode) для использования сервера MCP:
   http://localhost:8765

Инструменты МКП

Сервер обеспечивает следующие функции MCP:

• create_document — Создать новый документ Word
  • Параметры: filePath (обязательно), title, author
• open_document — Открыть существующий документ Word
  • Параметры: filePath (обязательно)
• add_paragraph — Добавить абзац в документ
  • Параметры: filePath (обязательно), text (обязательно), style, alignment
• add_table — Добавить таблицу в документ
  • Параметры: filePath (обязательно), rows (обязательно), cols (обязательно), headers, data
• search_and_replace - Найти и заменить текст в документе
  • Параметры: filePath (обязательно), searchText (обязательно), replaceText (обязательно), matchCase
• set_page_margins — Установить поля страницы документа
  • Параметры: filePath (обязательно), top, right, bottom, left
• get_document_info — Получить метаданные документа
  • Параметры: filePath (обязательно)

Интеграция с приложениями ИИ

Курсор

1. Откройте файл конфигурации курсора ~/.cursor/mcp.json
2. Добавьте следующую конфигурацию:

Или для локальной версии разработки:

После настройки вы сможете использовать естественный язык для работы с документами Word:

VSCode и другие MCP-совместимые инструменты

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

Разработка

Чтобы расширить или изменить этот сервер MCP:

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

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

3. Запуск в режиме разработки:

4. Сборка для производства:

Добавление новых функций MCP

1. Добавить новые методы в src/services/DocumentService.ts
2. Регистрация новых функций в src/mcp-server.ts
3. При необходимости обновите определения типов.

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

• Порт по умолчанию: 8765 (настраивается)
• Поддерживаемые типы файлов: .docx
• Все пути к файлам должны быть абсолютными или относительными к текущему рабочему каталогу.

Лицензия

Массачусетский технологический институт

Поддерживать

Если у вас возникли какие-либо проблемы или есть предложения по улучшению, пожалуйста, отправьте сообщение о проблеме в наш репозиторий GitHub.