@kvmfleet/mcp — MCP server (read-only)

A Model Context Protocol server that lets AI assistants (Claude Desktop, Cursor, Continue, etc.) read your KVM Fleet fleet state through the official REST API. All access is RBAC-enforced and audited on the server side.

Tools (read-only)

Tool	Maps to
list_devices	GET /v1/devices
get_device_health	GET /v1/devices (filtered)
query_audit_log	GET /v1/audit/events
verify_audit_integrity	GET /v1/audit/integrity
list_open_console_sessions	GET /v1/console-sessions?open_only=true

Write tools (start_console_session, power_cycle, mount_iso, …) are not yet exposed. They will land in a future release behind an explicit scope on the API token, never on a token that doubles as a user session.

Install

npm install -g @kvmfleet/mcp

Or use npx directly in the Claude Desktop config below.

Get an API token

1. Log into app.kvmfleet.io.
2. Account → API tokens → Create token.
3. Copy the token (shown exactly once).

The token inherits your current org role. Revoke any time from the same page — it stops working immediately.

Wire up Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kvmfleet": {
      "command": "npx",
      "args": ["-y", "@kvmfleet/mcp"],
      "env": {
        "KVMFLEET_API": "https://app.kvmfleet.io",
        "KVMFLEET_TOKEN": "kvmf_paste_your_token_here"
      }
    }
  }
}

Restart Claude Desktop. You can now ask:

• "How many devices do I have? Which are offline?"
• "Verify my audit log integrity."
• "Show me failed logins in the last 24 hours."
• "Are any console sessions still open?"

Privacy

The token is sent to your KVM Fleet platform only — never to Anthropic, the MCP package, or any third party. Read the platform's Privacy Policy for what's logged on our side (audit-event row per call).

Local dev

cd kvmfleet/mcp
npm install
npm run build
npm start