What can you do with this server?

The vmm-mcp-server provides an MCP interface to the VMM API, enabling management of network topologies, VMs, configurations, YAML/JSON conversion, and leases. Current state: Only vmm_list_topologies is exposed in the active server schema. The project defines many additional tools (per README): * Topology Management: List, launch, validate, bind/start/stop/unbind VMs, export/import/clone topologies. * Configuration Management: Upload configs, show active config, and manage a library of saved configs (list, get, save, remove). * YAML/JSON Conversion: Parse lab YAML to quickstart spec JSON, render JSON to YAML, and convert existing VMM configs to lab YAML. * Lease Management: Check lease status, schedule earlier unbind, and extend leases. All operations leverage the vmm-api CLI.

How do I use vmm-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vmm-mcp-server List all network topologies." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

vmm-mcp-server

An MCP server for VMM, a tool for creating and managing network topologies. It wraps the vmm-api CLI and exposes its subcommands as MCP tools so any MCP-compatible client (Claude Code, Claude Desktop, etc.) can drive VMM.

Tools

Tool	VMM CLI command	Description
`vmm_list_topologies`	`vmm-api ls`	List all network topologies known to VMM.
`vmm_launch_topology`	`vmm-api launch`	Configure, bind, and start a topology in one step.
`vmm_upload_config`	`vmm-api config`	Upload a topology config without binding/starting it.
`vmm_show_active_config`	`vmm-api config-print`	Display the currently active topology config.
`vmm_validate_topology`	`vmm-api validate`	Dry-run capacity check for a config, no deployment.
`vmm_bind_vms`	`vmm-api bind`	Launch VMs' QEMU processes, paused.
`vmm_start_vms`	`vmm-api start`	Start paused VMs (binds first if needed).
`vmm_stop_vms`	`vmm-api stop`	Pause QEMU emulation without deleting the process.
`vmm_unbind_vms`	`vmm-api unbind`	Release VMs (hard teardown, no guest shutdown).
`vmm_export_topology`	`vmm-api export`	Print a topology's userdb as JSON.
`vmm_import_topology`	`vmm-api import`	Recreate a topology from exported JSON.
`vmm_clone_topology`	`vmm-api clone`	Copy a topology's config into a new topo_id.
`vmm_yaml_parse`	`vmm-api yaml parse`	Lab YAML -> normalized quickstart spec JSON.
`vmm_yaml_render`	`vmm-api yaml render`	Quickstart spec JSON -> clean lab YAML.
`vmm_yaml_convert`	`vmm-api yaml convert`	Existing VMM config -> lab YAML.
`vmm_list_saved_configs`	`vmm-api configs list`	List your saved-config library.
`vmm_get_saved_config`	`vmm-api configs get`	Print one saved config.
`vmm_save_config`	`vmm-api configs save`	Store a config file into the saved-config library.
`vmm_remove_saved_config`	`vmm-api configs rm`	Delete a saved config.
`vmm_lease_status`	`vmm-api lease`	Show lease expiry and extensions used/remaining.
`vmm_schedule_unbind`	`vmm-api lease schedule`	Move auto-unbind earlier than the lease expiry.
`vmm_extend_lease`	`vmm-api extend`	Extend a topology's lease by 30 days.

More tools (e.g. auth) can be added as needed — see Adding a new tool.

Related MCP server: vsphere-mcp

Requirements

Node.js >= 18
The vmm-api CLI installed and available on PATH (or point VMM_API_BIN at it)

Install & build

npm install
npm run build

Configuration

The server reads two optional environment variables:

Variable	Default	Purpose
`VMM_API_BIN`	`vmm-api`	Path to the VMM CLI executable.
`VMM_API_TIMEOUT_MS`	`30000`	Timeout for each `vmm-api` invocation, in milliseconds.

Running

npm start

The server speaks MCP over stdio, so it's meant to be launched by an MCP client rather than run standalone. For example, in Claude Code's mcp config:

{
  "mcpServers": {
    "vmm": {
      "command": "node",
      "args": ["/absolute/path/to/vmm-mcp-server/dist/index.js"],
      "env": {
        "VMM_API_BIN": "/usr/local/bin/vmm-api"
      }
    }
  }
}

During development you can run it directly from TypeScript without building first:

npm run dev

Adding a new tool

Each tool is a small, self-contained module:

Create src/tools/<name>.ts exporting a VmmTool (see src/tools/types.ts) that calls runVmmApi([...]) from src/lib/vmmApi.ts with the right vmm-api args.
Register it by adding it to the array in src/tools/index.ts.

No changes to src/index.ts are needed — it registers whatever tools are listed there.

Project layout

src/
  index.ts              MCP server entry point (stdio transport, tool registration)
  lib/
    vmmApi.ts            Wrapper around spawning the vmm-api CLI
    args.ts              Helpers for building argv from flags (-x, --require, repeated -r, ...)
  tools/
    types.ts             Shared VmmTool interface + runAsToolResult() helper
    schemas.ts            Shared zod field definitions (groupId, requires, topoId, vmNames)
    listTopologies.ts    vmm_list_topologies      -> vmm-api ls
    launchTopology.ts    vmm_launch_topology      -> vmm-api launch
    uploadConfig.ts       vmm_upload_config        -> vmm-api config
    configPrint.ts         vmm_show_active_config   -> vmm-api config-print
    validateTopology.ts    vmm_validate_topology    -> vmm-api validate
    vmLifecycle.ts         vmm_bind_vms/start_vms/stop_vms/unbind_vms -> bind/start/stop/unbind
    exportTopology.ts      vmm_export_topology      -> vmm-api export
    importTopology.ts      vmm_import_topology      -> vmm-api import
    cloneTopology.ts       vmm_clone_topology       -> vmm-api clone
    yaml.ts                vmm_yaml_parse/render/convert -> vmm-api yaml ...
    savedConfigs.ts        vmm_*_saved_config(s)    -> vmm-api configs ...
    lease.ts               vmm_lease_status/schedule_unbind/extend_lease -> lease/extend
    index.ts               Registry of all tools

Available Tools

1 tool

vmm_list_topologiesList VMM topologiesA

List all network topologies known to VMM by running "vmm-api ls". Use this to discover existing topology names/IDs before creating, inspecting, or modifying one.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.2/5.0

Scored 2026-08-06 05:30 across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusing it with another. The purpose of vmm_list_topologies is clearly described and unambiguous.

Naming Consistency5/5

The single tool follows a clear verb_noun pattern with a consistent namespace prefix (vmm_list_topologies), establishing a clear convention that is internally consistent.

Tool Count1/5

A single tool for a VMM server is an extreme mismatch. The description implies create, inspect, and modify operations that are entirely absent, making the tool surface far too thin for its apparent scope.

Completeness1/5

The server exposes only a list operation. There are no create, get, update, delete, or other management capabilities, leaving massive gaps that would prevent any meaningful workflow beyond discovery.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

jumpcloud-genai
com.jumpcloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Cloud Platforms Security Developer Tools
2
https://mcp.jumpcloud.com/v1
serverA
io.cycloid.mcp
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Developer Tools CI/CD & DevOps Cloud Platforms
132
https://mcp.cycloid.io/mcp
vulners-mcpA
io.github.vulnersCom
MCP server for the Vulners.com API
Security Penetration Testing Search
717
https://mcp.vulners.com/mcp
Airweave Search
io.github.airweave-ai
MCP server for searching Airweave collections with natural language queries.
Search Art & Culture Open Data
25,729
https://mcp.airweave.ai/mcp

Related MCP Servers

mcp-proxmox
Virtualization Cloud Platforms Monitoring
felhen-ai
A
license
A
quality
B
maintenance
MCP server for managing Proxmox VE clusters — provision VMs and containers, manage snapshots and backups, execute commands, browse storage, and monitor resources through natural language
Updated 3 days ago (2026-11-12 11:47 UTC)
37
289 PyPI
18
MIT
vsphere-mcp
Virtualization Cloud Platforms
fukui-yuto
A
license
Not graded
quality
D
maintenance
MCP server for VMware vSphere/vCenter operations, enabling natural language control of VMs, hosts, and infrastructure.
Updated 5 months ago (2026-06-22 17:24 UTC)
Apache 2.0
NetBox MCP Server
Networking & Infrastructure Developer Tools
epe105
A
license
Not graded
quality
D
maintenance
MCP server for interacting with NetBox API, enabling users to query and manage NetBox resources such as devices through natural language.
Updated a year ago (2025-10-29 17:51 UTC)
MIT
pnetlab-mcp-server
Networking & Infrastructure Virtualization Command Line
raybiko-lab
A
license
A
quality
C
maintenance
MCP server for controlling PNETLab v6 network labs via natural language, enabling topology creation, node management, config push, console interaction, and link fault injection.
Updated 2 months ago (2026-09-18 08:55 UTC)
24
1
Apache 2.0