hpe-networking-mcp — инструментарий HPE Networking MCP

Баннер показывает актуальное состояние внутреннего каталога: большая поверхность инструментов остаётся доступной по запросу, тогда как сам MCP-клиент по умолчанию видит только три роутер-инструмента.

Низкотокеновый сервер Model Context Protocol (MCP) для автоматизации HPE Networking: Aruba Central, HPE GreenLake Platform (GLP), ClearPass, Juniper Mist, Apstra, автоматизация миграции ArubaOS 8, EdgeConnect, HPE Aruba UX и Axis Atmos Cloud.

MCP позволяет ИИ-клиенту — Claude Code, Copilot, Cursor, VS Code или любому другому узлу, поддерживающему MCP — обращаться к общему инструментарию вместо отдельного плагина для каждого вендора. hpe-networking-mcp — один из таких серверов: подключите к нему любой MCP-клиент, и он откроет доступ к поисковому каталогу операций HPE Networking через компактную поверхность с низким расходом токенов.

hpe-networking-mcp даёт ИИ-клиентам, работающим через MCP, низкопотребляющий по токенам способ искать документацию Aruba/HPE, сверяться с точными деталями OpenAPI, проверять состояние Central, запускать сценарии устранения неполадок, управлять конфигурацией, выполнять защищённые миграции ArubaOS 8 и применять защищённые операции GreenLake Platform. Он построен на прямых REST-вызовах через httpx.

Полное визуальное описание той же информации — выбор аудитории, диаграммы и схема безопасности записи — находится на сайте hpe-networking-mcp на GitHub Pages. Этот README намеренно короткий; канонические руководства лежат в docs/.

Почему роутер важен

Подключите ваш MCP-клиент к одному серверу: src/hpe_networking_mcp/mcp_servers/tool_router.py. Рекомендуемый профиль minimal держит видимый клиенту список инструментов из трёх позиций, обеспечивая доступ ко всем внутренним каталогом:

1. find_tool — найти нужный внутренний инструмент.

2. invoke_read_tool — выполнить только читающий вызовы.

3. invoke_tool — выполнить только намеренные операции записи/удаления.

Related MCP server: Network AI Assistant

Для кого это

Пятиминутный быстрый старт без учётных данных

Проверьте установку и запустите MCP HTTP-сервер, прежде чем добавлять какие-либо учётные данные Aruba Central или GreenLake Platform.

Вариант A — используйте опубликованный образ (без клонирования репозитория):

docker run -d --name hpe-networking-mcp \
  -p 127.0.0.1:8010:8010 \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_ALLOWED_HOSTS='127.0.0.1:*,localhost:*' \
  -e MCP_ALLOWED_ORIGINS='http://127.0.0.1:*,http://localhost:*' \
  ghcr.io/secure-ssid/hpe-networking-mcp:latest

Как только запуск завершится (за несколько секунд), curl http://127.0.0.1:8010/livez ответит {"status":"ok"}. Публикация только на loopback не выводит сервер за пределы вашей локальной сети; форма allowlist с host:* обязательна, если MCP_HOST не указывает на loopback. Индекс спецификаций OpenAPI встроен в образ во время сборки; для семантического ранжирования дополнительно нужна пересборка с экстразависимостями индексации (--build-arg INSTALL_EXTRAS=ingestion, см. Production deployment).

Вариант B — сборка из исходников (добавляет мастер настройки, диагностику doctor и локальный инструментарий для индекса):

git clone https://github.com/secure-ssid/hpe-networking-mcp.git
cd hpe-networking-mcp
python3 scripts/setup_wizard.py --yes --skip-credentials
uv run hpe-mcp-doctor
MCP_PORT=8010 bash scripts/run_http_router.sh

Ожидаемые результаты:

• Мастер печатает каждый выполненный этап и завершается сводкой о готовности настройки; никаких вызовов к Central/GLP не выполняется. На хостах Windows собирайте и запускайте из оболочки с переводами строк LF (WSL2 или настроенный checkout) — строки CRLF ломают входные скрипты в Docker-сборках.

• doctor.py отчитывается о проверках локальных зависимостей, путей конфигурации и индекса — всё возвращает OK или список того, что стоит исправись, без обращения к какому-либо API вендора.

• HTTP-роутер выводит строку Uvicorn running on http://127.0.0.1:8010 и продолжает работать в активном режиме.

Подключите любой MCP-совместимый клиент к http://127.0.0.1:8010/mcp и попробуйте поиск инструмента без учётных данных:

find_tool("list Aruba Central devices")

Ожидаемый результат: ранжированные совпадения читаются прямо из локального индекса инструментов, который только что построил мастер, каждое помеченное своей capability и состоянием write-gate. Никаких обращений к API вендора не происходит.

Подключение в вашем клиенте

Направьте любой MCP-совместимый клиент на http://127.0.0.1:8010/mcp (или конфигурацию stdio hpe-mcp-router) — и он увидит только три роутер-инструмента. Готовые конфиги для Claude, Copilot, VS Code, Cursor и других — в "MCP client recipes"; поставляемые примеры лежат в examples/mcp-clients/.

Поиск по документации — это отдельная локальная сборка

ask_docs и вся остальная RAG-поверхность требуют корпус прозы, которого этот проект сознательно не поставляет. Этот корпус — собранные веб-краулером материалы документации вендоров, и перепубликовывать их не в нашей власти — см. ingestion/source_manifest.json, который всегда гласил «Do not commit scraped content». Соберите его самостоятельно, приняв на себя условия каждого вендора:

uv run --extra ingestion python ingestion/ingest_docs.py

Закладывайте на это время. Сам обход измеряется часами, а первый RAG-запрос дополнительно загружает клиент эмбеддингов nomic-embed-text-v1.5 размером ~250 МБ в ваш кэш Hugging Face. Без учётных данных не значит офлайн: быстрый старт выше не требует вендорских учётных данных, но и сборка корпуса, и первый запрос требуют доступа в сеть.

Безопасность записи в двух словах

• find_tool только ищет в локальном каталоге инструментов; он никогда не вызывает API вендора.

• invoke_read_tool блокирует любой внутренний инструмент, который не помечен как read-only.

• invoke_tool намеренно помечен как деструктивный, потому что он может выполнять и write/деструктивные внутренние инструменты — используйте его только тогда, когда это действительно задумана операция записи.

• При поддержке сначала используйте dry_run=True; реальное выполнение потребует либо confirm=True, либо запроса подтверждения через MCP, в зависимости от схемы инструмента.

• Запись включается вручную (opt-in) на каждой платформе, включая Central: при профиле по умолчанию HPE_MCP_ACCESS_PROFILE=custom гейт записи каждой платформы закрыт, пока вы его не открыли. Используйте safe-read-only, чтобы заблокировать любые записи голосов от персональных гейтов платформ, или full-read-write, чтобы включить обычные записи на каждой подключенной платформе.

• Полный режим чтения/записи не отменяет dry-run, подтверждение, запрос через MCP и выделенную защиту, например отдельный гейт отката AOS8.

• Учётные данные хранятся в config/credentials.yaml или переменных окружения и никогда не коммитятся.

Деструктивные операции (reboot_device, disconnect_client) ограничиваются то ли флагом, что и записи — отдельного «операционного» уровня, который бы это обходил, нет.

Полную модель discovery/диспетчеризации/безопасности записи см. в Tool router.

Состояние проекта

Полные счётчики инструментов по каждому бэкенду приведены в Каталоге инструментов. Всё, что добавлено в последнем тегированном релизе, описано в примечаниях к выпуску 0.9.0, а воспроизводимые сравнения инструментов и бенчмарков — в матрице функциональных разрывов.

Руководства по задачам

Основы локальной настройки

Стандартный профиль MCP-клиента остаётся минимальным:

HPE_MCP_ROUTER_MODE=minimal
HPE_MCP_TOOLSETS=central,glp,rag

Дополнительные продукты включайте только при необходимости:

HPE_MCP_ACCESS_PROFILE=custom
HPE_MCP_PRODUCTS=clearpass,mist,apstra,aos8,edgeconnect,uxi,axis,design
HPE_MCP_PRODUCT_ACCESS=read-only

Полная модель настройки и безопасности описана в матрице дополнительных продуктов.

Для доверенного сеанса с полным доступом на запись используйте python3 scripts/setup_wizard.py --access-profile full-read-write, чтобы все устаревшие разрешающие механизмы были согласованы, либо автономный examples/mcp-clients/stdio/full-read-write.mcp.json.

В ../.claude/launch.json поставляется соответствующий минимальный профиль запуска hpe-networking-mcp для повседневной работы. find_tool по умолчанию не показывает полные JSON-схемы; include_schema=true запрашивайте только в том случае, если клиенту нужна полная форма параметров.

Создайте или обновите индекс инструментов маршрутизатора и базу данных API-спецификаций. Обе сущности получаются из закоммиченных в этот репозиторий OpenAPI-спецификаций, поэтому пересобираются детерминированно и не требуют скрейпинга:

uv run python scripts/ingest_tools.py --products all

Текстовый корпус для RAG собирается отдельно скриптом ingestion/ingest_docs.py, как описано в кратком руководстве выше. Он не распространяется как релизный артефакт.

Учётные данные, выбор региона, переменные окружения дополнительных продуктов и полный путь загрузки/обновления данных см. в разделе Начало работы.

Режим Streamable HTTP

MCP_PORT=8010 bash scripts/run_http_router.sh

Затем направьте любого MCP-совместимого клиента на http://127.0.0.1:8010/mcp. Сервер также открывает /livez, /readyz и /healthz. Привязка к адресам, отличным от loopback, требует явного указания MCP_ALLOWED_HOSTS/MCP_ALLOWED_ORIGINS и может быть защищена с помощью MCP_HTTP_BEARER_TOKEN. Готовые конфигурации stdio и HTTP для копирования/вставки — в рецептах для MCP-клиентов.

Структура проекта

src/hpe_networking_mcp/mcp_servers/     Low-token router + Central/GLP/RAG/optional-product servers
src/hpe_networking_mcp/pipeline/        httpx clients, 8-stage migration pipeline, SSID helpers
ingestion/       Docs/API scraping and LanceDB + SQLite index builders
docs/            Setup, router, architecture, product, and release guides
scripts/         Setup wizard, doctor wrapper, HTTP router helper, release validation
tests/           Unit, integration, and RAG eval coverage
config/          Credentials template; real credentials stay git-ignored
examples/        Tested, non-secret MCP client/prompt/runbook configuration examples
run_pipeline.py  Checkout wrapper for `hpe-mcp-run-pipeline`
run_ssid.py      Checkout wrapper for `hpe-mcp-run-ssid`

Полная карта репозитория, включая генерируемые и игнорируемые git-ей пути, находится в разделе Обзор системы.

Проверка

uv run pytest tests/unit -q
uv run python scripts/validate_release.py --catalog-products all --strict-tool-index --min-tools 6711

--min-tools 6711 задаёт нижнюю границу совместимости с платформенными API (это 6,711 инструментов платформенных API вендора), а не полное зарегистрированное количество инструментов бэкенда — 6,728, которое также включает протокол-инструмент Central Streaming, кроссплатформенный агрегатор site-health, локальную предварительную диагностику GLP и локальные инструменты без учётных данных. Проверка проходит на или выше этой нижней границы. Оба значения см. в Каталоге инструментов.

Помощник выпуска запускает модульные тесты, при наличии индексов — необязательные оценочные прогоны RAG/API, проверки нижней границы каталога инструментов и проверки актуальности локального индекса инструментов. Модульные тесты также включают статические проверки активного кода MCP/конвейера, включённых в репозиторий примеров конфигураций MCP с маленьким количеством токенов, локальных конфигурационных файлов, документации рута по продуктам и наборам инструментов, ограниченных универсальных GET-инструментов только для чтения, границ по умолчанию для списков MCP, ограничений top_k для RAG/поиска, публичных утверждений о количестве инструментов, обратных версией строк количества инструментов, отображаемых факт-утверждений о документах в RAG/индексе, отслеживаемых локальных Markdown-ссылок и изображений, метаданных sitemap и robots для Pages, документированных примеров аргументов маршрутизатора, таблицы имён инструментов в продуктовых рабочих процессах и таблиц переменных окружения для дополнительных продуктов в мастере.

Смежные проекты и благодарности

hpe-networking-mcp — это независимый инструментарий HPE Networking MCP, который улучшается с учётом официальной экосистемы MCP и работ сообщества:

• HewlettPackard/gl-mcp — официальный MCP-сервер платформы GreenLake

• modelcontextprotocol/python-sdk — MCP Python SDK

• KarthikSKumar98/central-mcp-server — community-мервер Aruba Central MCP от сообщества

• nowireless4u/hpe-networking-mcp — унифицированный MCP-справочник HPE Networking

Отказ от ответственности

hpe-networking-mcp — независимый community-проект. Это не официальный продукт HPE или HPE Aruba Networking, и он не одобрен и не поддерживается компанией HPE.

Лицензия

MIT — см. лицензию репозитория. Сгенерированные метаданные API и ссылки на вышестоящие реализации upstream описаны в THIRD_PARTY_NOTICES.md.