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 сессии хранится открытым текстом.
Настройка клиентов
{
"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 для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.