Oleafly MCP
Редактор LaTeX, Typst и Markdown с локальным MCP-сервером: агент читает, правит и компилирует открытый проект
- 1 181 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Агент читает, создает, переименовывает и удаляет файлы открытого проекта, перезаписывая рукописи, если подтвердить правку
- Токен в `mcp.json` открывает локальный порт на время работы сервера
Установка
- Работает в
Ручная установка
claude mcp add --transport http oleafly http://127.0.0.1:5323/mcp --header "Authorization: Bearer <token>"Сначала включите сервер в настройках Oleafly и возьмите токен там же.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает, создает, переименовывает и удаляет файлы открытого проекта, перезаписывая рукописи, если подтвердить правку
- Токен в `mcp.json` открывает локальный порт на время работы сервера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Oleafly — настольный редактор научных текстов на LaTeX, Typst и Markdown для macOS, Windows и Linux. Он может работать как MCP-сервер: любой MCP-клиент управляет проектом, который открыт в редакторе, теми же инструментами и с теми же запросами на подтверждение, что и встроенный помощник. Ключ API в самом Oleafly для этого не нужен, модель приносит внешний клиент. Инструменты делятся на группы. Обзор: `get_status`, `list_projects`, `open_project`, `list_files`, `project_map`, `search_project`. Чтение: `read_file`, `get_log`, `get_pdf_text`, `verify_pdf_pages`. Правка: `write_file`, `replace_in_file`, `create_file`, `rename_file`, `delete_file`, `set_main_doc`. Сборка и рисунки: `compile`, `preview_figure`, `insert_figure`, `load_image`. Сервер слушает только `127.0.0.1`, работает, пока приложение запущено, и требует токен из настроек.
Для кого. Исследователям и студентам, которые пишут статьи и диссертации в LaTeX или Typst и хотят, чтобы Claude Code или Codex правил текст в их проекте.
Подходит, если
- Статья не компилируется, и агент должен прочитать лог сборки, найти ошибку в `.tex` и исправить
- Перед отправкой в журнал нужно найти неразрешенные ссылки и пропавшие рисунки по карте проекта
- Рисунок в TikZ или Typst хочется получить по описанию: агент строит его, смотрит PNG и вставляет в документ
- Подписка на Claude уже есть, и платить за отдельный ключ API для редактора не хочется
Не подходит, если
- Проект лежит в Overleaf или другом облаке, а на компьютере не открыт в Oleafly: сервер работает только с открытым проектом
- Приложение закрыто или компьютер выключен: сервер исчезает вместе с процессом редактора
- Агент должен работать на удаленной машине: сервер слушает только этот компьютер
Пример запроса к агенту
Скомпилируй мой проект, прочитай лог, исправь ошибку в главе 3 и покажи, что изменилосьMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Ограничения
Проект находится в бете. Сервер включают вручную в разделе Settings, Integrations, Oleafly MCP, а токен лежит в файле `mcp.json` рядом с данными Oleafly, пока сервер запущен; обращайтесь с ним как с локальным секретом. Порт по умолчанию 5323, при занятости выбирается другой и запоминается. Удаление файлов всегда требует подключенного окна редактора. Лицензия AGPL-3.0. Для сборки нужен компилятор: Tectonic, Typst и Pandoc встроены, а полному дистрибутиву TeX Live придется быть установленным отдельно.
Как отключить. Выключите переключатель Enable MCP server в настройках Oleafly или закройте приложение, затем удалите блок oleafly из конфигурации клиента, например `claude mcp remove oleafly`.
Частые вопросы
Как подключить Oleafly к Claude Code?
Включите сервер в настройках Oleafly и выполните `claude mcp add --transport http oleafly http://127.0.0.1:5323/mcp --header "Authorization: Bearer <token>"`. Живой адрес и токен показаны в тех же настройках, порт может отличаться от 5323.
Нужен ли ключ API внутри Oleafly?
Нет. Внешнее приложение приносит свою модель, а Oleafly отдает ему инструменты проекта.
Как подключить Claude Desktop?
Claude Desktop предпочитает stdio, поэтому в `claude_desktop_config.json` добавляют мост `mcp-remote`: команда `npx` с аргументами `-y mcp-remote@latest`, адресом сервера, заголовком Authorization и `--transport http-only`.
Может ли агент удалять файлы проекта?
Да, есть инструмент `delete_file`, но удаление всегда идет через подключенное окно редактора и подчиняется тем же запросам на подтверждение, что и встроенный помощник.
Какие форматы документов поддерживаются?
LaTeX, Typst и Markdown. Движок документа показывает `get_status`, а инструменты `preview_figure` и `insert_figure` работают в проектах LaTeX и Typst.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Overleaf: агент читает проект LaTeX через Git, находит разделы и правит их с коммитом
CLI для Overleaf: вытягивает проекты LaTeX в папку, отправляет правки, компилирует PDF и отдает их агенту через MCP
Overleaf MCP Server — LaTeX-проекты через Git
Overleaf MCP Server (YounesBensafia)
Агент читает и правит файлы проекта Overleaf через штатную Git-синхронизацию и сам отправляет изменения в проект
Aldine — свой редактор LaTeX с совместной работой и git, где встроенный MCP дает Claude править и собирать документ.
Плагин OpenMarkdown открывает Markdown агента в локальном редакторе и ведет совместное редактирование через MCP
Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Oleafly (эта карточка) | да | API-ключ | 1 181 | |
| Typst agent skills | нет | 239 | скиллы для написания документов на Typst, без редактора, компиляции и управления открытым проектом | |
| Overleaf Remote Skill | нет | 120 | скилл для работы с проектом в Overleaf, а не с локальной сборкой в настольном редакторе |
Коротко о README
Текст представляет Oleafly как живой совместный редактор для научной работы с компиляцией на компьютере, историей Git, поиском литературы и проверками перед подачей. Про агентов сказано отдельно: Claude Code, Codex и еще 12 работают внутри проекта, а MCP-сервер описан в `docs/mcp.md`.