Mastering LangGraph Agent Skill MCP — Сценарии использования, Установка & Живое демо

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

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

Девять подробных справочных руководств (основной API, ReAct, ветвление, постоянство, HITL, мультиагентность, развертывание, отладка, введение)
Восемь канонических шаблонов, охватывающих один агент, несколько агентов и производство.
Более 150 ссылок на официальную документацию LangGraph для более подробной информации.
Устанавливается через Skilz с глобальным или индивидуальным масштабом проекта.
Agent Skill Standard — работает с 14+ агентами кодирования, а не только с Клодом.

Живое демо

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

mastering-langgraph-skill.replay ▶ готово

0/0

Установка

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

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

{
  "mcpServers": {
    "mastering-langgraph-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "-g",
        "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
      ],
      "_inferred": false
    }
  }
}

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

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

{
  "mcpServers": {
    "mastering-langgraph-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "-g",
        "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
      ],
      "_inferred": false
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mastering-langgraph-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "-g",
        "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
      ],
      "_inferred": false
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mastering-langgraph-skill": {
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "-g",
        "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
      ],
      "_inferred": false
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mastering-langgraph-skill",
      "command": "pip",
      "args": [
        "install",
        "skilz",
        "&&",
        "skilz",
        "install",
        "-g",
        "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "mastering-langgraph-skill": {
      "command": {
        "path": "pip",
        "args": [
          "install",
          "skilz",
          "&&",
          "skilz",
          "install",
          "-g",
          "https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill"
        ]
      }
    }
  }
}

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

claude mcp add mastering-langgraph-skill -- pip install skilz && skilz install -g https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill

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

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

Реальные сценарии: Mastering LangGraph Agent Skill

Создайте инструмент, использующий агент ReAct с контрольным указателем.

👤 Разработчики Python запускают новый проект LangGraph ⏱ ~45 min intermediate

Когда использовать: В качестве отправной точки вам нужен работающий агент цикла инструментов, а не еще один пустой блокнот.

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

Python 3.10+ и пип — pyenv или системный Python
LangGraph + ядро LangChain — pip install langgraph langchain-core

Поток

Установить навык

pip install Skilz && Skilz install -g https://github.com/SpillwaveSolutions/mastering-langgraph-agent-skill✓ Скопировано

→ Навык появляется в ~/.claude/skills/.
Запросите эшафот ReAct

Создайте агент ReAct с помощью двух инструментов (поиск + калькулятор) и контрольной точки MemorySaver.✓ Скопировано

→ Работоспособный код с графиком, инструментами и контрольными точками
Беги и проходи мимо

Запустите его с помощью thread_id='thread-1' и покажите мне состояние на каждом этапе.✓ Скопировано

→ Снимки состояния на каждом шаге подтверждают, что цикл работает.

Итог: Работающий агент, который можно расширить, а не начинать с нуля.

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

Использование InMemorySaver в производстве — Переключитесь на контрольно-пропускной пункт Postgres перед отправкой; руководство описывает замену

Сочетать с: fastmcp

Создайте многоэтапный конвейер с условной маршрутизацией.

👤 Бэкэнд-инженеры заменяют специальные цепочки типизированными графами ⏱ ~60 min intermediate

Когда использовать: В вашем рабочем процессе есть ветви (классифицировать → маршрут → специализировать → финализировать), и вам нужно явное состояние.

Поток

Опишите ветки

Составьте LangGraph для: классификации намерений → маршрута к сумматору или вопросов и ответов → завершения цитатами.✓ Скопировано

→ Графическая диаграмма и код; явные условные ребра
Добавить контрольную точку

Добавьте контрольный указатель, чтобы возобновить работу в середине потока.✓ Скопировано

→ Состояние сохраняется между вызовами

Итог: Типизированный конвейер, который можно тестировать и возобновлять.

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

Рассматривать каждый узел как вызов LLM — Узлы чистого Python, не относящиеся к LLM, часто более понятны и дешевле.

Сочетать с: langsmith-fetch-skill

Сделайте паузу для одобрения человека перед рискованным действием.

👤 Команды, запускающие агентов в производственных системах ⏱ ~30 min intermediate

Когда использовать: Агент собирается потратить деньги, отправить кому-нибудь электронное письмо или изменить состояние — вам нужен контрольно-пропускной пункт с участием человека.

Поток

Добавить узел прерывания

Вставьте прерывание человеческого одобрения перед узлом send_email; покажи как возобновить.✓ Скопировано

→ прерывание_перед подключением + очистка API возобновления
Тестирование путей одобрения и отклонения

Напишите сценарий, который проверяет потоки одобрения и отклонения.✓ Скопировано

→ Два пути пройдены чисто

Итог: Люди делают рискованный шаг; утвержденные действия выполняются до завершения.

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

Забыть сохранить состояние во время прерывания — Прерываниям нужен контрольный указатель; без этого пауза бесполезна

Сочетать с: linear

Проектирование многоагентной системы супервизора или роя

👤 Архитекторы, оценивающие многоагентные шаблоны ⏱ ~90 min advanced

Когда использовать: Один агент запутался или стал слишком большим; вы рассматриваете шаблоны оркестровки.

Поток

Пройдитесь по компромиссам

Сравните супервизора и роя для команды исследователя + программиста + рецензента.✓ Скопировано

→ Явные плюсы/минусы; когда выбирать каждый
Выбор и эшафот

Создайте выбранный шаблон с помощью трех агентов.✓ Скопировано

→ Работоспособный код с логикой маршрутизации/хэндовера

Итог: Принципиальный выбор мультиагентного шаблона с работающим кодом.

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

Внедрение мультиагента до того, как будет отлажен один агент — Запустить одиночный агент; разделяться только тогда, когда вы достигнете конкретных пределов

Сочетать с: server-mas-sequential-thinking

Перенесите LangGraph с ноутбука на производство

👤 Возможности экспедиторского агента инженеров ⏱ ~60 min advanced

Когда использовать: У вас есть рабочий график, и вам нужен реальный план развертывания.

Поток

Выберите цель развертывания

Сравните платформу Docker + LangGraph с автономным размещением; рекомендую для небольшой команды.✓ Скопировано

→ Конкретные рекомендации с учетом соотношения затрат/операций
Трассировка проводов

Добавьте трассировку LangSmith с областью проекта.✓ Скопировано

→ Следы видны в LangSmith при правильном названии проекта.

Итог: Путь развертывания, который вы можете показать команде платформы.

Сочетать с: cloud-run

Комбинации

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

mastering-langgraph-skill + fastmcp

Оберните свой LangGraph как сервер MCP, чтобы его могли использовать другие агенты.

Предоставьте текущий график как инструмент MCP через fastmcp.✓ Скопировано

mastering-langgraph-skill + langsmith-fetch-skill

Получите трассировки для отладки и верните их в диалог.

Получите последние 10 трассировок проекта «продукт-агент» и шаблоны отказов поверхности.✓ Скопировано

mastering-langgraph-skill + server-mas-sequential-thinking

Объедините шаблоны многоагентного последовательного мышления с оркестровкой LangGraph

Сопоставьте график своего супервизора с шаблоном MAS последовательного мышления.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать	Стоимость
skill: mastering-langgraph	natural-language LangGraph questions and tasks	Всякий раз, когда вы создаете или отлаживаете LangGraph	0

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

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

Квота API: Нет для навыков; ваш провайдер LLM взимает плату за основные звонки
Токенов на вызов: Зависит от разделов, на которые загружаются навыки — узкие вопросы делают его небольшим
Деньги: Свободный навык; взимаются расходы поставщика (OpenAI/Anthropic/и т. д.)
Совет: Задавайте целевые вопросы «как мне использовать <X> в LangGraph». Широкая тема «Научи меня LangGraph» содержит огромные справочные разделы.

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

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

Хранение учётных данных: Нет в навыке; ваши собственные учетные данные LLM и инструментов остаются в вашем менеджере среды/секрета.

Исходящий трафик: Содержание навыков является локальным. Любой выход происходит из кода, который вы запускаете (вызовы инструментов, LangSmith).

API LangGraph быстро развиваются. Перед отправкой сверьте примеры навыков с текущей версией LangGraph.

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

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

Установка Skilz завершается неудачей: «репозиторий не найден»

Используйте флаг -g с полным URL-адресом GitHub, а не с коротким путем SkillzWave, если торговая площадка не настроена.

Проверить: pip show skilz && skilz list -g

Код графа выполняется локально, но прерывается при развертывании

Обычно выбор контрольного указателя — InMemorySaver не выдерживает перезапуска. Переключитесь на Postgres или Redis в разделе развертывания.

Проверить: Inspect the checkpointer type in your code

Следы ЛэнгСмита пропали

Установите LANGSMITH_API_KEY и LANGCHAIN_PROJECT перед вызовом графика.

Проверить: echo $LANGSMITH_API_KEY | head -c 5

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

Mastering LangGraph Agent Skill в сравнении

Альтернатива	Когда использовать	Компромисс
mcp-agent	Вам нужны шаблоны агентов MCP, а не LangGraph.	Другая структура, другая экосистема
server-mas-sequential-thinking	Вам нужен готовый многоагентный сервер последовательного мышления.	Менее гибко, чем создание в LangGraph
agent-langchainjs	Вы используете JS/TS, а не Python	Другая языковая цель

Ещё

Ресурсы

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

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

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