💻 mcp-vnc

Ein Model Context Protocol (MCP)-Server, der es KI-Agenten ermöglicht, Windows, Linux, macOS oder alles andere, das einen VNC-Server ausführen kann, remote zu steuern (keine Sorge, es ist wahrscheinlich in Ordnung).

🚀 Schnellstart

Von NPM installieren

npm install -g @hrrrsn/mcp-vnc

Aus dem Quellcode installieren

git clone https://github.com/hrrrsn/mcp-vnc
cd mcp-vnc
npm install
npm run build

Related MCP server: mcp-vnc

⚙️ Konfiguration

Claude Desktop

1. Suchen und öffnen Sie Ihre Konfigurationsdatei für Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Fügen Sie die folgende Konfiguration hinzu:

Bei Installation über NPM:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

Bei Installation aus dem Quellcode:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "stdio",
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-vnc",
      "env": {
        "VNC_HOST": "192.168.1.100",
        "VNC_PORT": "5900",
        "VNC_PASSWORD": "your-vnc-password",
        "VNC_TIMEOUT": "30000"
      }
    }
  }
}

VNC_TIMEOUT (optional) legt fest, wie lange jeder Tool-Aufruf auf die Verbindung zum VNC-Server und die Bereitstellung des ersten Frames wartet, in Millisekunden. Standardwert ist 30000.

VS Code

Bitte lesen Sie die VS Code-Dokumentation

HTTP-Transport (Streamable HTTP)

Standardmäßig verwendet der Server stdio. Um ihn stattdessen über HTTP bereitzustellen:

# Via environment variables
VNC_HOST=192.168.1.100 VNC_PORT=5900 VNC_PASSWORD=secret \
MCP_TRANSPORT=http MCP_PORT=3000 mcp-vnc

# Or via CLI arguments
mcp-vnc --http --port 3000

Der MCP-Endpunkt ist dann unter http://localhost:3000/mcp verfügbar. Beispiel für eine Client-Konfiguration:

{
  "mcpServers": {
    "vnc-controller": {
      "type": "http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

🛠️ Verfügbare Tools

Der MCP-Server stellt die folgenden Tools zur Fernsteuerung des Desktops bereit:

🖱️ Maussteuerung

Beispiel: vnc_click(x=100, y=200, button="right", double=true)

Beispiel: vnc_move_mouse(x=500, y=300)

⌨️ Tastatursteuerung

Unterstützte Tasten:

• Einzeltasten: a, Enter, F1, Escape, Up, Down, Tab, Space

• Tastenkombinationen: Ctrl+c, Alt+F4, Ctrl+Alt+Delete, Shift+Tab

• Modifikatoren: Ctrl, Alt, Shift, Super/Win, Meta/Cmd

Beispiele:

• vnc_key_press(key="Enter")

• vnc_key_press(key="Ctrl+Alt+Delete")

📝 Texteingabe

Beispiel: vnc_type_text(text="Hello World!", enter=true)

Beispiel: vnc_type_multiline(lines=["Line 1", "Line 2", "Line 3"])

📸 Bildschirmaufnahme

Beispiel: vnc_screenshot(delay=1000) - 1 Sekunde vor der Aufnahme warten

🤝 Mitwirken

Beiträge sind willkommen! Reichen Sie gerne einen Pull Request ein.

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die Datei LICENSE für Details.