MCP-сервер для маршрутизаторов VyOS, работающий на VyManager.

VyMCP позволяет агентам ИИ читать и управлять маршрутизаторами VyOS через API VyManager, наследуя аутентификацию VyManager, RBAC, аудит и безопасность подтверждения обязательств. Он никогда не обращается напрямую к маршрутизаторам.

Статус: альфа Запускается локально (stdio) или как общий хостинг-сервер (http); интерфейсы могут меняться.

##Установка

Или pip install . от клона, или запустить Docker изображение ghcr.io/community-vyprojects/vymcp (прикреплено -i).

Настройка

Установите переменные среды (см. .env.example):

| Переменная | Требуемая | Цель [править править код] VYMANAGER_BASE_URL | Да | VyManager API URL | VYMANAGER_API_TOKEN | Да | Токен vym_ (Сайты → Токены API; рекомендуется только для чтения) | VYMANAGER_ENABLE_WRITES | Нет | Включить инструменты записи (по умолчанию) |

[8] true и VYMANAGER_TIMEOUT 30 являются необязательными.

##Подключите MCP-клиент

Распределенное развертывание (общий сервер)

Запустите один VyMCP, к которому многие инженеры подключаются через HTTP, каждый из которых аутентифицируется с помощью протокола. собственный токен VyManager по запросу:

[12], [13], [[13]], [[13]], [[13]]. Инженеры точка

VyMCP

MCP server for VyOS routers, powered by VyManager.

VyMCP lets AI agents read and manage VyOS routers through the VyManager API — inheriting VyManager’s authentication, RBAC, audit, and commit-confirm safety. It never talks to routers directly.

Status: alpha. Runs local (stdio) or as a shared hosted server (http); interfaces may change.

Install

pipx install git+https://github.com/Community-VyProjects/VyMCP   # provides `vymcp`

Or pip install . from a clone, or run the Docker image ghcr.io/community-vyprojects/vymcp (attached, with -i).

Configure

Set environment variables (see .env.example):

VYMANAGER_VERIFY_SSL (default true) and VYMANAGER_TIMEOUT (default 30) are optional.

Connect an MCP client

{
  "mcpServers": {
    "vymcp": {
      "command": "vymcp",
      "env": {
        "VYMANAGER_BASE_URL": "https://vymanager.example.com",
        "VYMANAGER_API_TOKEN": "vym_…"
      }
    }
  }
}

Hosted deployment (shared server)

Run one VyMCP that many engineers connect to over HTTP, each authenticating with their own VyManager token per request:

docker compose up -d          # see docker-compose.yml

Set VYMANAGER_BASE_URL and VYMCP_PUBLIC_URL in the compose file. Engineers point their MCP client at https:///mcp with Authorization: Bearer vym_…. Terminate TLS at a reverse proxy and run a single replica (the pending-change store is in-memory).

Tools

• Read (always): list_instances, list_features, get_capabilities, get_config.
• Write (only when VYMANAGER_ENABLE_WRITES=true): describe_feature_operations + propose_operations cover ~86 features; apply_change / confirm_change / discard_changes / get_pending_changes drive the rollout.

Writes are safe by design: off by default, capped to the token’s scope, and gated by a propose → apply flow. apply_change requires explicit confirmation and rides VyManager’s commit-confirm auto-rollback (a lockout safety net) — it never auto-confirms.

Development

pip install -e ".[dev]"
pytest && ruff check . && mypy

License

GPLv3 — see LICENSE.