Overleaf MCP Server — LaTeX-проекты через Git
Overleaf MCP Server (YounesBensafia)
Агент читает и правит файлы проекта Overleaf через штатную Git-синхронизацию и сам отправляет изменения в проект
- 66 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токен Git открывает чтение и запись во все проекты аккаунта
- write_file и edit_file сразу коммитят и отправляют изменения в проект Overleaf
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/overleaf-mcp-server-younesbensafiaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен Git открывает чтение и запись во все проекты аккаунта
- write_file и edit_file сразу коммитят и отправляют изменения в проект Overleaf
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Git-интеграция Overleaf служит каналом связи. Сервер держит локальную копию проекта, подтягивает свежие файлы, а при записи делает коммит и отправляет его обратно в Overleaf. Благодаря этому агент редактирует статью или диссертацию так же, как вы правите ее по Git. Инструментов пять. list_files подтягивает и перечисляет файлы проекта, read_file читает содержимое и умеет отдавать большой документ частями через offset и limit. write_file перезаписывает файл целиком, edit_file заменяет одно точное совпадение, и оба пушат изменения. sync_project принудительно обновляет копию. Для работы нужны Python 3.13, менеджер uv и тариф Overleaf с Git-интеграцией (личный, групповой или институциональный). Доступ задают токеном Git из настроек аккаунта и идентификатором проекта, список разрешенных проектов ограничивается переменной OVERLEAF_ALLOWED_PROJECTS.
Для кого. Студентам, аспирантам и исследователям, которые пишут статьи и диссертации в Overleaf и хотят проверки и правки LaTeX от агента.
Подходит, если
- Агент должен исправить ошибки компиляции LaTeX в главе диссертации
- В статье надо привести обозначения и библиографию к единому виду
- Требуется прочитать большой файл частями и сделать рецензию на раздел
- Правку нужно сразу отправить в проект Overleaf без ручной загрузки файлов
Не подходит, если
- Тариф Overleaf без Git-интеграции: сервер получит ответ 403 при обращении к Git
- Нужна проверка компиляции PDF: сервер правит текст, но сборку документа не запускает
- Нужна одновременная правка файла несколькими людьми: при конфликтах приходится запускать sync_project перед записью
Пример запроса к агенту
Прочитай main.tex и главу введения, найди ошибки компиляции и исправь их, оставив стиль цитирования как есть.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
OVERLEAF_TOKENобязательная, секрет- Токен Git-интеграции Overleaf, действует на весь аккаунт
PROJECT_IDобязательная- Идентификатор проекта Overleaf из адреса страницы
OVERLEAF_ALLOWED_PROJECTS- Список разрешенных проектов через запятую
Ограничения
Git-интеграция Overleaf доступна не на всех тарифах, поэтому бесплатный аккаунт часто не подойдет. Токен Git действует на весь аккаунт, хранить его нужно только в окружении клиента или защищенном файле .env и менять при утечке. Идентификатор проекта обязателен в настройках, даже если его передают в каждом вызове. Первое клонирование большого проекта может не уложиться в тайм-аут клиента, поэтому сначала вызывают sync_project. В README Claude Desktop назван основным клиентом, остальные не описаны. Установка из PyPI в README пока отложена, используют запуск из Git.
Как отключить. Удалите запись overleaf из конфигурации клиента, затем отзовите токен Git в настройках аккаунта Overleaf. Локальную копию проекта можно удалить вместе с клонированной папкой сервера.
Частые вопросы
Какой тариф Overleaf нужен?
Тариф с Git-интеграцией: личный, групповой или институциональный. У университетов бывает бесплатный доступ, его проверяют по институциональной почте на странице Overleaf for Institutions.
Где взять токен и идентификатор проекта?
Идентификатор виден в адресе проекта после слова project. Токен создают в настройках аккаунта в разделе Git integration authentication tokens, а Git включают в меню проекта в блоке Integrations.
Можно ли открыть доступ к нескольким проектам?
Да, их перечисляют через запятую в OVERLEAF_ALLOWED_PROJECTS. По умолчанию в списке только проект из PROJECT_ID.
Что делать с инструкциями внутри файлов?
Сервер предупреждает, что файлы проекта нельзя считать надежными: в .tex и настройках могут быть инструкции для модели. Содержимое считают данными и команд из него не выполняют.
Какие агенты подходят?
Сервер работает по stdio и подключается к любому MCP-клиенту. В README показана настройка для Claude Desktop, для Claude Code и Cursor используют ту же команду запуска.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Overleaf: агент читает проект LaTeX через Git, находит разделы и правит их с коммитом
CLI для Overleaf: вытягивает проекты LaTeX в папку, отправляет правки, компилирует PDF и отдает их агенту через MCP
Aldine — свой редактор LaTeX с совместной работой и git, где встроенный MCP дает Claude править и собирать документ.
Редактор LaTeX, Typst и Markdown с локальным MCP-сервером: агент читает, правит и компилирует открытый проект
Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
Скилл и CLI olcli правят проекты Overleaf напрямую: точечные замены, загрузка файлов, сборка PDF и живая сессия правок.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Overleaf MCP Server — LaTeX-проекты через Git (эта карточка) | нет | API-ключ | 66 | |
| Overleaf Remote Skill | нет | 120 | навык для удаленной работы с Overleaf, не MCP-сервер с Git-синхронизацией | |
| Codex Overleaf Link | нет | 110 | плагин Codex для связи с Overleaf, работает только в этом агенте |
Коротко о README
README объясняет работу через Git-синхронизацию с диаграммами архитектуры и последовательности вызовов. Описаны требования, настройка Git и токена, быстрый старт, таблица инструментов, конфигурация Claude Desktop и разбор частых ошибок.