Сервер MCP Word Tools

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

Функции

• Полная реализация протокола MCP

• Создание и управление документами Word

• Манипулирование содержимым расширенного текста

• Создание и форматирование таблиц

• Контроль макета документа

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

• Мониторинг состояния документа в режиме реального времени

Related MCP server: MCP Word Commander

Предпосылки

• Node.js 14 или выше

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

Установка

npx @puchunjie/doc-tools-mcp

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

npm install -g @puchunjie/doc-tools-mcp

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

npm install @puchunjie/doc-tools-mcp

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

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

npx @puchunjie/doc-tools-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. Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "npx",
      "args": [
        "@puchunjie/doc-tools-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "doc-tools-mcp": {
      "command": "node",
      "args": [
        "/path/to/your/doc-tools-mcp/dist/mcp-server.js"
      ]
    }
  }
}

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

"Create a new document named report.docx"
"Add a heading 'Monthly Report' to report.docx"
"Insert a 4x3 table with sales data"

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

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

Разработка

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

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

git clone <repository-url>
cd doc-tools-mcp

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

npm install

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

npm run start

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

npm run build

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

1. Добавить новые методы в src/services/DocumentService.ts

2. Регистрация новых функций в src/mcp-server.ts

3. При необходимости обновите определения типов.

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

• Порт по умолчанию: 8765 (настраивается)

• Поддерживаемые типы файлов: .docx

• Все пути к файлам должны быть абсолютными или относительными к текущему рабочему каталогу.

Лицензия

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

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

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