kvm-pilot MCP
A write-capable, multi-plane MCP server for controlling physical machines via KVM, BMC, and SSH. It enables AI agents to perform bare-metal operations like OS installation and firmware updates by analyzing KVM screenshots and executing commands, supporting safety gates and vision-based boot phase detection.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Drive a headless box through POST and firmware updates
- Perform OS installation without an agent on the target
- Control physical machines via PiKVM or GLKVM
- Manage BMC operations using Redfish or IPMI
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
kvm-pilot 1.0.1
{
"version": "1.0.1",
"transport": "stdio",
"identifier": "kvm-pilot",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "KVM_PILOT_PROFILE",
"description": "Profile name from ~/.config/kvm-pilot/config.toml naming the KVM/BMC to target"
},
{
"name": "KVM_PILOT_MCP_READ_ONLY",
"description": "Least-privilege posture: only read-only tools are registered; effect gates force-closed. Recommended for first contact (set to 1)"
},
{
"name": "KVM_PILOT_MCP_DRY_RUN",
"description": "Rehearsal posture: destructive calls are logged, never sent (set to 1)"
},
{
"name": "KVM_PILOT_MCP_ALLOW_POWER",
"description": "Operator opt-in enabling power control of the managed host (per-effect gate; see also _ALLOW_HID, _ALLOW_MEDIA, _ALLOW_SSH, _ALLOW_APPLIANCE, _ALLOW_EXTERNAL_WRITE)"
},
{
"name": "KVM_PILOT_HOST",
"description": "Device address (KVM/BMC) when not using a config-file profile"
},
{
"name": "KVM_PILOT_USER",
"description": "Device username when not using a config-file profile"
},
{
"name": "KVM_PILOT_PASSWD",
"description": "Device password when not using a config-file profile (KVM_PILOT_HOST / KVM_PILOT_USER accompany it)"
},
{
"name": "ANTHROPIC_API_KEY",
"description": "Optional: enables server-side vision for classify_screen / wait_for_state; without it, classification falls back to the calling agent"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"kvm-pilot-mcp": {
"command": "uvx",
"args": [
"kvm-pilot==1.0.1"
],
"env": {
"KVM_PILOT_PROFILE": "<YOUR_KVM_PILOT_PROFILE>",
"KVM_PILOT_MCP_READ_ONLY": "<YOUR_KVM_PILOT_MCP_READ_ONLY>",
"KVM_PILOT_MCP_DRY_RUN": "<YOUR_KVM_PILOT_MCP_DRY_RUN>",
"KVM_PILOT_MCP_ALLOW_POWER": "<YOUR_KVM_PILOT_MCP_ALLOW_POWER>",
"KVM_PILOT_HOST": "<YOUR_KVM_PILOT_HOST>",
"KVM_PILOT_USER": "<YOUR_KVM_PILOT_USER>",
"KVM_PILOT_PASSWD": "<YOUR_KVM_PILOT_PASSWD>",
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Cline
{
"mcpServers": {
"kvm-pilot-mcp": {
"command": "uvx",
"args": [
"kvm-pilot==1.0.1"
],
"env": {
"KVM_PILOT_PROFILE": "<YOUR_KVM_PILOT_PROFILE>",
"KVM_PILOT_MCP_READ_ONLY": "<YOUR_KVM_PILOT_MCP_READ_ONLY>",
"KVM_PILOT_MCP_DRY_RUN": "<YOUR_KVM_PILOT_MCP_DRY_RUN>",
"KVM_PILOT_MCP_ALLOW_POWER": "<YOUR_KVM_PILOT_MCP_ALLOW_POWER>",
"KVM_PILOT_HOST": "<YOUR_KVM_PILOT_HOST>",
"KVM_PILOT_USER": "<YOUR_KVM_PILOT_USER>",
"KVM_PILOT_PASSWD": "<YOUR_KVM_PILOT_PASSWD>",
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}VS Code
{
"servers": {
"kvm-pilot-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kvm-pilot==1.0.1"
],
"env": {
"KVM_PILOT_PROFILE": "<YOUR_KVM_PILOT_PROFILE>",
"KVM_PILOT_MCP_READ_ONLY": "<YOUR_KVM_PILOT_MCP_READ_ONLY>",
"KVM_PILOT_MCP_DRY_RUN": "<YOUR_KVM_PILOT_MCP_DRY_RUN>",
"KVM_PILOT_MCP_ALLOW_POWER": "<YOUR_KVM_PILOT_MCP_ALLOW_POWER>",
"KVM_PILOT_HOST": "<YOUR_KVM_PILOT_HOST>",
"KVM_PILOT_USER": "<YOUR_KVM_PILOT_USER>",
"KVM_PILOT_PASSWD": "<YOUR_KVM_PILOT_PASSWD>",
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"kvm-pilot-mcp": {
"command": "uvx",
"args": [
"kvm-pilot==1.0.1"
],
"env": {
"KVM_PILOT_PROFILE": "<YOUR_KVM_PILOT_PROFILE>",
"KVM_PILOT_MCP_READ_ONLY": "<YOUR_KVM_PILOT_MCP_READ_ONLY>",
"KVM_PILOT_MCP_DRY_RUN": "<YOUR_KVM_PILOT_MCP_DRY_RUN>",
"KVM_PILOT_MCP_ALLOW_POWER": "<YOUR_KVM_PILOT_MCP_ALLOW_POWER>",
"KVM_PILOT_HOST": "<YOUR_KVM_PILOT_HOST>",
"KVM_PILOT_USER": "<YOUR_KVM_PILOT_USER>",
"KVM_PILOT_PASSWD": "<YOUR_KVM_PILOT_PASSWD>",
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Let your agent find its tools
Find servers like kvm-pilot MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.