olcli

olcli — MCP-сервер сообщества (автор — aloth). Проекты Overleaf: файлы, компиляция в PDF, сравнение и комментарии. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
aloth
Лицензия
MIT
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
typescript

Уровень риска: high

Меняет проекты Overleaf (файлы, комментарии, изменения) после подтверждения; cookie сессии хранится открытым текстом.

Настройка клиентов

codex
{
    "code": "[mcp_servers.overleaf]\ncommand = \"npx\"\nargs = [\"-y\", \"--package\", \"@aloth/olcli\", \"olcli-mcp\"]",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README; или .codex/config.toml в доверенном проекте",
    "verified": "docs"
}

Что умеет

olcli — утилита командной строки для Overleaf: можно работать с LaTeX-проектами в терминале, редакторе или через ИИ-агента, а соавторы продолжают пользоваться веб-редактором Overleaf. В одном пакете — утилита, помощник git для Overleaf, MCP-сервер olcli-mcp и библиотека на TypeScript.

Возможности:

  • синхронизация: скачивание, загрузка и двусторонняя синхронизация с вложенными папками; служебные файлы сборки LaTeX игнорируются;
  • сравнение локальных файлов с проектом на Overleaf до отправки, в том числе для проверок в CI;
  • версии с пометками: PDF с зачёркиваниями и подчёркиваниями через latexdiff, собранный на Overleaf без локального TeX;
  • сборка и скачивание PDF, отдельного корневого документа или выходных файлов вроде .bbl для arXiv;
  • файлы: загрузка, скачивание, удаление, переименование, перемещение, архив проекта;
  • комментарии: просмотр, добавление, ответы, закрытие, повторное открытие и удаление;
  • отслеживаемые изменения: просмотр, принятие и отклонение (только в проектах с платным тарифом Overleaf);
  • проекты: создание и переименование.

Всё, кроме отслеживаемых изменений, проверено на бесплатном тарифе overleaf.com. Работает и с самостоятельно развёрнутым Overleaf Community Edition. Токен git и платный тариф не нужны — olcli использует обычную сессию Overleaf.

Кому подойдёт

  • Аспирантам и исследователям: правка диссертации в привычном редакторе и синхронизация с соавторами.
  • Тем, кто готовит статьи к подаче: PDF с пометками для научного руководителя, файлы для arXiv.
  • Тем, кто поручает агенту ответы на комментарии рецензентов и правки текста.

Похожие серверы — в категории наука и образование.

Установка

Установка через Homebrew или npm (нужен Node 20.18.1 или новее):

npm install -g @aloth/olcli

Затем войдите в Overleaf командой olcli auth --browser: она откроет страницу входа во временном профиле браузера (не в вашем), дождётся входа и сохранит только cookie сессии. Работают SSO, Google, ORCID и двухфакторный вход; пароль olcli не видит. Для этого нужен Node 22 или новее. Без браузера можно вставить cookie командой olcli auth --cookie. Для своего сервера Overleaf задайте адрес через OVERLEAF_BASE_URL.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "overleaf": {
      "command": "npx",
      "args": ["-y", "--package", "@aloth/olcli", "olcli-mcp"]
    }
  }
}

JSON-конфиг добавляют в .mcp.json для Claude Code или .cursor/mcp.json для Cursor. Codex читает TOML из ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Сервер использует сессию, сохранённую olcli auth; вместо неё можно передать OVERLEAF_SESSION в env.

Проверка

Выполните olcli auth status — команда покажет экземпляр Overleaf, аккаунт и источник учётных данных. Затем попросите агента вывести список ваших проектов Overleaf.

Примеры задач

Покажи открытые комментарии в проекте «Диссертация» с двумя строками контекста.
Сравни мою локальную версию с проектом на Overleaf и собери PDF с пометками изменений.

Риски

  • Изменение проектов Overleaf. Агент может загружать и удалять файлы, переименовывать, комментировать, принимать и отклонять изменения, создавать проекты. По README, каждый такой инструмент показывает, что собирается сделать, и пишет только после вашего подтверждения в клиенте.
  • Cookie сессии. Хранится открытым текстом и даёт полный доступ к аккаунту Overleaf. Пароль сохраняется только с флагом --save-password. olcli logout удаляет учётные данные.
  • Локальные файлы. Скачивание перезаписывает файлы с флагом --force, синхронизация удаляет на Overleaf файлы, удалённые локально (отключается --no-delete).
  • Содержимое проектов. Сервер предупреждает агента, что комментарии и текст документов — это данные, а не инструкции.

Частые вопросы

Нужен ли платный тариф Overleaf?

Нет. Всё, кроме отслеживаемых изменений, работает на бесплатном тарифе.

Как olcli обращается к Overleaf без публичного API?

Через сессию браузера: утилита использует cookie вашего входа.

Что делать, если сессия истекла?

Выполните olcli auth ещё раз; olcli auth status покажет, какие учётные данные использовались.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники