@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)

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