Overleaf MCP Server
MCP-сервер для Overleaf: агент читает проект LaTeX через Git, находит разделы и правит их с коммитом
- 334 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токен Git дает полный доступ на чтение и запись ко всему проекту Overleaf
- Инструменты write_file и write_section изменяют файлы проекта и создают коммиты
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/overleaf-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен Git дает полный доступ на чтение и запись ко всему проекту Overleaf
- Инструменты write_file и write_section изменяют файлы проекта и создают коммиты
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает проекты Overleaf к MCP-клиенту через интеграцию с Git. Агент получает список файлов проекта, по умолчанию .tex, читает любой из них и разбирает структуру LaTeX-документа на разделы и подразделы. Содержимое одного раздела можно запросить по заголовку, не загружая весь файл. Всего инструментов восемь, и пишут в проект только два. write_file заменяет файл целиком, а write_section обновляет один раздел. Каждая запись идет с обязательным сообщением коммита. Проектов можно подключить несколько. Для одного хватит переменных окружения OVERLEAF_PROJECT_ID и OVERLEAF_GIT_TOKEN. Для нескольких в каталоге конфигурации создается файл projects.json, а в вызове инструмента указывается projectName. Пути от агента ограничены клонированным проектом: выход через .. и абсолютные пути сервер отклоняет.
Для кого. Для авторов статей и диссертаций в LaTeX, которые работают в Overleaf и хотят поручить агенту чтение и правку разделов.
Подходит, если
- Нужно получить структуру длинной диссертации: список разделов и подразделов файла main.tex
- Требуется прочитать только раздел «Introduction», не загружая весь документ
- Хотите, чтобы агент переписал один раздел и сохранил правку коммитом в Overleaf
- Работаете сразу с несколькими проектами Overleaf и переключаетесь между ними по имени
- Перед правкой нужна сводка по проекту: файлы и структура документа
Не подходит, если
- Нужна сборка PDF или проверка компиляции: сервер работает с текстом файлов
- Проект лежит вне Overleaf: для обычных файлов LaTeX достаточно обычного доступа агента к папке
- Нужна работа без сети: сервер обращается к Git Overleaf по интернету
Пример запроса к агенту
Покажи разделы файла main.tex в проекте thesis и перепиши раздел Introduction короче, сохранив ссылки на литературу.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
OVERLEAF_PROJECT_IDобязательная- Идентификатор проекта из адреса Overleaf.
OVERLEAF_GIT_TOKENобязательная, секрет- Токен Git Integration из настроек аккаунта Overleaf.
OVERLEAF_GIT_TOKEN_FILE- Путь к файлу с токеном вместо OVERLEAF_GIT_TOKEN.
OVERLEAF_PROJECTS_CONFIG- Абсолютный путь к нестандартному projects.json.
Ограничения
Нужны Node.js и клиент MCP, например Claude Desktop. На Windows запуск через npx требует обертки cmd /c. Сервер читает и пишет файлы через клон проекта по Git, и каждому проекту нужны свои идентификатор и токен. Список файлов по умолчанию показывает только .tex. Доступность Overleaf из России мы не проверяли. Если конфигурацию клиента синхронизируют или копируют в резервные копии, токен лучше вынести в отдельный файл.
Как отключить. Уберите блок overleaf из claude_desktop_config.json и перезапустите клиента. Токен можно отозвать в настройках Overleaf, в разделе Git Integration.
Частые вопросы
Где взять идентификатор проекта и токен Overleaf?
Идентификатор виден в адресе открытого проекта: https://www.overleaf.com/project/ИДЕНТИФИКАТОР. Токен создается в настройках аккаунта Overleaf, раздел Git Integration, кнопка Create Token.
Как подключить несколько проектов Overleaf?
Создайте projects.json в ~/.config/overleaf-mcp (на Windows в %APPDATA%\overleaf-mcp) с записями projectId и gitToken для каждого проекта. Блок env в настройках клиента тогда не требуется, в вызове инструмента передается projectName.
Как не хранить токен в настройках клиента?
Задайте OVERLEAF_GIT_TOKEN_FILE с путем к текстовому файлу вместо OVERLEAF_GIT_TOKEN. Файл читается один раз при старте, пробелы и перевод строки в конце обрезаются.
Может ли агент испортить проект?
Может, если записать неудачный текст: write_file и write_section меняют файлы и делают коммит. Токен дает полный доступ к проекту, поэтому перед записью просите агента показать текст.
Что умеет write_section?
Инструмент заменяет содержимое одного раздела, найденного по заголовку. В newContent передается новый текст вместе со строкой заголовка, например с командой раздела в LaTeX, и обязательное сообщение коммита.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
MCP-сервер на базе pandoc: агент конвертирует Markdown, HTML, DOCX, LaTeX, EPUB, ODT и другие форматы друг в друга
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
PageIndex MCP — длинные PDF для агента
PageIndex MCP
MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Overleaf MCP Server (эта запись) | нет | API-ключ | 334 | |
| LaTeX Document Skill | нет | 804 | навык Claude Code, который по описанию создает документ LaTeX с нуля | |
| mcp-pandoc | нет | не нужна | 584 | конвертация документов между форматами на базе pandoc |
Коротко о README
Быстрая настройка занимает один блок JSON для Claude Desktop, для Windows дан отдельный вариант. В конце есть проверка протокола из терминала и заметки по безопасности.