OverleafMCP (MCP server) — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Чтение дерева проекта и отдельных .tex-файлов
Парсинг LaTeX в дерево разделов/подразделов
Отправка правок через Git bridge Overleaf (без риска перезаписи)
Инспекция BibTeX для работы с цитатами
Работает с любым платным тарифом Overleaf, открывающим доступ к Git

Живое демо

Как выглядит на практике

overleaf-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "overleaf-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "overleaf-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mjyoo2/overleaf-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add overleaf-mcp -- npx -y @mjyoo2/overleaf-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: OverleafMCP

Сократить раздел статьи, не выходя из Claude

👤 Исследователи, технические авторы ⏱ ~20 min intermediate

Когда использовать: Рецензент №2 написал, что раздел 3 многословен — у вас 30 минут на исправление.

Предварительные требования

Платный тариф Overleaf с доступом к Git — Account → Account Settings → Git authentication

Поток

Найти

Use Overleaf MCP. Find section 3 in main.tex. Show me current text.✓ Скопировано

→ Текст раздела возвращён с диапазоном строк
Переписать

Tighten this 30%. Keep technical terms intact. Don't drop citations.✓ Скопировано

→ Сокращённая версия с сохранёнными цитатами
Отправить

Replace section 3 with the rewrite. Commit with message 'Tighten §3 per reviewer 2'.✓ Скопировано

→ Git push выполнен; проект перерендерился в Overleaf

Итог: Правки попали в Overleaf — веб-интерфейс не открывался.

Подводные камни

Одновременные правки от соавтора вызывают конфликт — Делайте pull перед push; разрешайте конфликты в Claude с diff-контекстом

Сочетать с: filesystem

Аудит цитат в статье

👤 Авторы, финализирующие рукопись ⏱ ~15 min beginner

Когда использовать: Перед отправкой — убедиться, что у каждого \cite есть запись в .bib.

Поток

Инвентаризация

List every \cite{} key in main.tex. Cross-check against refs.bib.✓ Скопировано

→ Таблица соответствий; осиротевшие ключи помечены
Исправление

For each orphan key, suggest the closest match from .bib or mark as missing.✓ Скопировано

→ Рекомендация по каждому осиротевшему ключу

Итог: Ноль сломанных цитат перед кнопкой «Submit».

Подводные камни

Цитаты в комментариях тоже дают совпадения — Перед regex удалите LaTeX-комментарии

Переставлять разделы с уверенностью

👤 Авторы, перестраивающие главы ⏱ ~30 min advanced

Когда использовать: Порядок разделов нелогичен; хотите поменять местами разделы 2 и 4.

Поток

Карта

Show me the section tree of main.tex with line ranges.✓ Скопировано

→ Иерархическое дерево
Перестановка

Swap section 2 with section 4. Update internal references (\ref) accordingly.✓ Скопировано

→ Перестановка выполнена; ссылки проверены

Итог: Перестроенная статья компилируется без ошибок.

Подводные камни

Прямые ссылки ломаются — Компилируйте после перестановки; Claude может читать ошибки и исправлять

Комбинации

Сочетайте с другими MCP — эффект x10

overleaf-mcp + filesystem

Локальный бэкап статьи перед структурными правками

Snapshot the project to /papers/backup/ before any structural changes.✓ Скопировано

overleaf-mcp + github

Зеркало на GitHub для review через issue-трекер

Push the same commits to my GitHub mirror so co-authors can leave PR comments.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_files	(none)	Изучить структуру проекта	free
read_file	path	Получить .tex / .bib для инспекции	free
parse_structure	path	Составить план перед редактированием	free
edit_section	path, section_id, new_text	Точечная замена	free
git_push	message	Сохранить правки в Overleaf	free

Стоимость и лимиты

Во что обходится

Квота API: Git в Overleaf ограничен по частоте (работайте в разумных пределах)
Токенов на вызов: 500–10000 в зависимости от размера файла
Деньги: Бесплатный MCP; платный тариф Overleaf нужен для Git
Совет: Читайте разделы, а не целые файлы при итерациях

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Overleaf Git token — repo-level read/write

Хранение учётных данных: Переменная окружения OVERLEAF_GIT_TOKEN

Исходящий трафик: git.overleaf.com

Никогда не давайте: Token access to other people's projects

Токены привязаны к проекту; ротируйте при смене ноутбука

Устранение неполадок

Частые ошибки и исправления

Authentication failed during git_push

Токен мог истечь; перегенерируйте в настройках Overleaf

Проверить: git ls-remote с тем же URL+token

Tree-sitter LaTeX errors on parse

Некоторые макросы сбивают парсер; используйте read_file + ручное определение области

Push rejected (non-fast-forward)

Соавтор сделал push; сначала pull, разрешите конфликты, затем push

Альтернативы

OverleafMCP в сравнении

Альтернатива	Когда использовать	Компромисс
VimTeX / TeXShop locally	Облачная синхронизация вообще не нужна	Нет совместной работы Overleaf
Overleaf web editor	Только лёгкие правки	Нет доступа для агентов; вручную

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills