Tool // Кейс проекта

Pencil API

HTTP-микросервис, оборачивающий Pencil MCP для генерации презентационных слайдов. Принимает запросы, управляет жизненным циклом Pencil-процесса и возвращает готовые .pen-файлы.

Роль
Full-stack, Product
Релиз
март 2026 г.
Стек
Bun, TypeScript, JSON-RPC, Pencil MCP, systemd
01. Вызов

Нестабильный MCP

Pencil MCP накапливает открытые документы в памяти, из-за чего активный документ становится неоднозначным и генерация ломается.

  • После нескольких генераций export_nodes и batch_design падают с ошибкой «wrong .pen file»
  • Pencil не записывает .pen-файлы на диск — их нужно извлекать из памяти через batch_get
  • Явная передача filePath в MCP-инструменты вызывает нестабильные сбои
02. Решение

Чистый перезапуск

Перед каждой генерацией сервис перезапускает Pencil через systemd, гарантируя чистое состояние, и работает только с активным документом без явных путей.

  • Kill Pencil перед каждым запросом — systemd автоматически поднимает его заново за 5с
  • Все MCP-вызовы работают с активным документом через open_document, без передачи filePath
  • batch_get с nodeIds из snapshotLayout и readDepth: 10 извлекает полный .pen из памяти
Интерфейс проекта Pencil API

Интерфейс проекта Pencil API.

Задача → решение → результат

Логика проекта, а не схема передачи данных между сервисами

  1. NODE_01

    Задача проекта

    Pencil MCP накапливает открытые документы в памяти, из-за чего активный документ становится неоднозначным и генерация ломается.

  2. NODE_02

    Реализованное решение

    Перед каждой генерацией сервис перезапускает Pencil через systemd, гарантируя чистое состояние, и работает только с активным документом без явных путей.

  3. NODE_03

    Результат

    Ручная сборка слайдов → автоматическая генерация через API-вызов

Архитектура & Стек

Компоненты и технологии проекта

Bun · TypeScript

Приём API-запросов

Приём API-запросов

КОМПОНЕНТ / 01HTTP сервер
HTTP сервер
Bun · TypeScript

Приём API-запросов

Бизнес-показатели

Показатели проекта и отдельно обозначенные модели бизнес-эффекта.

PROJECT_METRIC_01
0

ручной сборки слайдов

Показатель из описания проекта

PROJECT_METRIC_02
~10с

гарантированно чистый старт

Показатель из описания проекта

PROJECT_METRIC_03
3x

retry на каждый слайд

Показатель из описания проекта

Подробнее о проекте

Генерация презентаций через API — задача, которая ломается из-за нестабильного состояния графического редактора.

Цель — обернуть Pencil в надёжный микросервис: перезапускать процесс перед каждым запросом и возвращать готовый файл без участия человека.

Ручная сборка слайдов → автоматическая генерация через API-вызов

BunTypeScriptJSON-RPCPencil MCPsystemd
Обсудим вашу задачу

Готовы обсудить ваш проект?

Проектирую и разрабатываю SaaS-продукты, архитектуру данных и интерфейсы, которые решают бизнес-задачи.

Заказать разработку
Следующий проект18ai