cml-mcp — Cisco Modeling Labs через MCP

cml-mcp

MCP-сервер для Cisco Modeling Labs: агент создает топологии, запускает узлы, настраивает связи и снимает трафик

  • 80 ★ репозитория
  • Последний коммит
  • BSD-2-Clause
MCP-сервер

Широкий доступ

Почему такой уровень

  • Агент создает и стирает лаборатории и меняет конфигурации виртуальных устройств
  • Учетные данные CML передаются серверу, а права администратора открывают управление пользователями
Все причины и проверки

xorrkaz/cml-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/cml-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент создает и стирает лаборатории и меняет конфигурации виртуальных устройств
  • Учетные данные CML передаются серверу, а права администратора открывают управление пользователями

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

cml-mcp связывает MCP-клиенты с сервером Cisco Modeling Labs (CML), где строят и запускают виртуальные сетевые лаборатории. Агент по просьбе на обычном языке создает лабораторию с двумя маршрутизаторами и настраивает OSPF или показывает рабочую конфигурацию устройства. Инструменты разбиты на модули: лаборатории, узлы, связи, захват пакетов, аннотации, пользователи и группы, сведения о системе. Агент запрашивает состояние лабораторий, узлов и связей, запускает, останавливает и стирает лабораторию или отдельный узел, задает задержку, потери и пропускную способность каналов, добавляет текстовые и графические пометки, запускает и забирает PCAP для Wireshark и читает консольные журналы узлов. С дополнением `cml-mcp[pyats]` через PyATS доступны `send_cli_command` и `send_cli_config_command` для команд на виртуальных устройствах. В режиме HTTP права на инструменты разграничиваются файлом YAML, а трассировка OpenTelemetry уходит в любой совместимый бэкенд.

Для кого. Сетевым инженерам и студентам, которые строят лаборатории в CML и хотят управлять ими из Claude Desktop или Claude Code.

Подходит, если

  • Требуется быстро собрать лабораторию с маршрутизаторами и настроить протокол маршрутизации
  • Агент снимает трафик на канале и отдает PCAP для разбора в Wireshark
  • Надо понизить качество канала: задержка, джиттер и потери для проверки приложения
  • Нужно прочитать консольный журнал узла при поиске ошибки

Не подходит, если

  • У вас нет сервера CML: инструмент работает только с Cisco Modeling Labs
  • Ваша задача — управление боевой сетью: сервер подключается только к лаборатории
  • Команды на устройствах не нужны или PyATS не ставится: тогда хватает базового пакета без `[pyats]`

Пример запроса к агенту

Создай в CML лабораторию из двух маршрутизаторов, соедини их, запусти и покажи рабочую конфигурацию первого.

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

CML_URL обязательная
Адрес сервера Cisco Modeling Labs
CML_USERNAME обязательная
Логин в CML
CML_PASSWORD обязательная, секрет
Пароль в CML
CML_VERIFY_SSL
Проверка TLS-сертификата, по умолчанию включена

Ограничения

Нужен доступ к серверу CML: адрес, логин и пароль в переменных `CML_URL`, `CML_USERNAME` и `CML_PASSWORD`. Сертификат CML по умолчанию самоподписанный, поэтому большинству нужно `CML_VERIFY_SSL=false`, а проверка включена по умолчанию. Для команд на устройствах нужно дополнение `[pyats]`.

Управление пользователями и группами требует прав администратора CML. Клиенты вроде Claude Desktop запускаются в ограниченной среде, и `uvx` иногда приходится указывать полным путем. Для Docker, Windows через WSL и режима HTTP есть отдельный файл `INSTALLATION.md`.

Как отключить. Удалите запись `Cisco Modeling Labs CML` из `claude_desktop_config.json` и при необходимости смените пароль учетной записи CML.

Частые вопросы

Как подключить cml-mcp к Claude Desktop?

Добавьте в `claude_desktop_config.json` сервер с командой `uvx` и аргументом `cml-mcp`, а в env задайте `CML_URL`, `CML_USERNAME`, `CML_PASSWORD` и `CML_VERIFY_SSL`.

Зачем нужен `CML_VERIFY_SSL=false`?

CML поставляется с самоподписанным сертификатом, поэтому проверка TLS при настройках по умолчанию не пройдет. Оставляйте `true`, если у вас доверенный сертификат.

Как выполнять команды на виртуальных устройствах?

Используйте `cml-mcp[pyats]`: тогда доступны `send_cli_command` и `send_cli_config_command` для режимов `exec` и конфигурации.

Можно ли ограничить права по инструментам?

В режиме HTTP да: список доступа в YAML определяет, какие пользователи вызывают какие инструменты.

Что умеет захват пакетов?

Запускает и останавливает захват на канале и забирает PCAP для Wireshark или другого анализатора.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер для Cisco Packet Tracer: агент планирует сеть, строит ее на холсте и подтверждает связность пингом.

MCP-серверШирокий доступ377Звезды репозитория
Официальный

MCP-сервер mcpcap разбирает PCAP-файлы по DNS, DHCP, ICMP, TCP и SIP и отдает агенту структурированный JSON для диагностики сети

MCP-серверРасширенный доступ54Звезды репозитория
Официальный

Локальный MCP-сервер Cisco: агент проектирует сеть и строит схемы L1, L2 и L3 в SVG и PowerPoint плюс таблицу устройств

MCP-серверРасширенный доступ419Звезды репозитория

MCPM

mcpm

Менеджер пакетов и реестр MCP для всех платформ и клиентов: ищет, добавляет и настраивает MCP-серверы, запоминает источник и обновляет

CLIРасширенный доступ1 тыс.Звезды репозитория

Локальная среда для агентов и MCP-шлюз с 298 инструментами: файлы, Git, процессы, браузер Chrome, Windows и Office

MCP-серверШирокий доступ209Звезды репозитория

MCP SSH Agent, MCP-сервер, берет хосты из ~/.ssh/config, запускает команды и копирует файлы через системные ssh и scp.

MCP-серверШирокий доступ105Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
cml-mcp — Cisco Modeling Labs через MCP (эта карточка)нетAPI-ключ80
NetBox MCP ServerдаAPI-ключ256инвентарь и документация сети NetBox без запуска виртуальных лабораторий
SSH MCPнетAPI-ключ878выполняет команды по SSH на реальных хостах

Коротко о README

README объясняет назначение сервера, перечисляет возможности и дает установку через `uvx` с примером конфигурации Claude Desktop. Дальше идут требования, таблицы инструментов по модулям, примеры запросов, системная подсказка, участие в проекте и разбор типичных ошибок: импорт, SSL и PyATS.

Бейдж для README

Сообщить о проблеме