Yambr/open-computer-use

Was macht open-computer-use?

MCP-Server, der jedem LLM einen eigenen Computer zur Verfügung stellt – verwaltete Docker-Workspaces mit Live-Browser, Terminal, Codeausführung, Dokumentfähigkeiten und autonomen Sub-Agenten. Selbst gehostet und Open-Source.

Funktionen

• Vollständiger Computerzugriff – Jeder Workspace läuft in einem dedizierten Docker-Container mit einem echten Linux-Dateisystem, Netzwerk und Prozessen.
• Live-Browser – Mithilfe von Playwright kann der LLM Websites in einem sichtbaren Chromium-Browser öffnen, scrollen, klicken und auslesen.
• Terminal – Shell-Zugriff innerhalb des Workspace, um Skripte auszuführen, Pakete zu installieren und das System zu steuern.
• Codeausführung – Python, JavaScript und andere Sprachen können direkt über einen Code-Executor ausgeführt werden.
• Dokumentfähigkeiten – PDF, Word, Excel und andere Dokumente können geöffnet, gelesen und verarbeitet werden.
• Autonome Sub-Agenten – Der LLM kann spezialisierte Sub-Agenten (z. B. für Browser, Terminal, Code) dynamisch starten und nach Abschluss zusammenführen.
• Selbst gehostet und Open-Source – Zertifizierte Docker-Images, die lokal ausgeführt werden können.

Unterstützte Plattformen

• Claude Desktop
• Cursor
• VS Code (mit Cline)
• Jeder MCP-kompatible Client

Schnellstart

Voraussetzung: Docker muss installiert sein.

1. Ausführung mit Docker (empfohlen)

docker run -i --rm \
  -e OPENAI_API_KEY=sk-... \
  -e ANTHROPIC_API_KEY=sk-... \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -p 3000:3000 \
  yambr/open-computer-use

2. Konfiguration in Ihrem Client

Beispiel für cline_mcp_settings.json:

{
  "mcpServers": {
    "open-computer-use": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "OPENAI_API_KEY=sk-...",
        "-e", "ANTHROPIC_API_KEY=sk-...",
        "-v", "/var/run/docker.sock:/var/run/docker.sock",
        "-p", "3000:3000",
        "yambr/open-computer-use"
      ]
    }
  }
}

Für Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "open-computer-use": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ANTHROPIC_API_KEY=sk-...",
        "-v", "/var/run/docker.sock:/var/run/docker.sock",
        "-e", "OCI_USER=user",
        "-e", "OCI_TOKEN=token",
        "-e", "OCI_SKILLS_MODE=browser,terminal,code,documents",
        "-p", "3000:3000",
        "yambr/open-computer-use"
      ]
    }
  }
}

3. Docker-Image lokal bauen

git clone https://github.com/yambr/open-computer-use.git
cd open-computer-use
cp env.example .env
docker compose up --build

Konfiguration

Umgebungsvariablen

Variable	Beschreibung	Erforderlich
OPENAI_API_KEY	OpenAI API-Schlüssel	Bedingt (entweder diesen oder ANTHROPIC_API_KEY)
ANTHROPIC_API_KEY	Anthropic API-Schlüssel	Bedingt (entweder diesen oder OPENAI_API_KEY)
PORT	Port des Servers (Standard: 3000)	Nein
OCI_USER	Benutzername für Open CoDE (falls verwendet)	Nein
OCI_TOKEN	Token für Open CoDE	Nein
OCI_SKILLS_MODE	Aktivierte Fähigkeiten, z. B. browser,terminal,code,documents	Nein
MAX_RUNNING_TIME	Maximale Laufzeit des Workspace in Minuten (Standard: 30)	Nein
MAX_SPEND_LIMIT	Maximales Ausgabenlimit in USD (Standard: 5)	Nein
DOCKER_REGISTRY	Docker-Registry zum Herunterladen von Images	Nein

Kostenlimits

Verwenden Sie MAX_RUNNING_TIME und MAX_SPEND_LIMIT, um die Kosten zu begrenzen. Der Server zählt die API-Kosten für LLM-Aufrufe, die innerhalb eines Workspace getätigt werden, und stoppt den Container, wenn das Limit erreicht ist.

Manuelle Installation (ohne Docker)

# Repository klonen
git clone https://github.com/yambr/open-computer-use.git
cd open-computer-use

# Konfigurationsdatei kopieren
cp env.example .env
# API-Schlüssel in .env eintragen

# Abhängigkeiten installieren
npm install

# Server starten
npm start

Hinweis: Für den manuellen Modus müssen Playwright-Browser manuell installiert werden. Führen Sie npx playwright install chromium aus, um Chromium herunterzuladen.

Lizenz

MIT

Haftungsausschluss

Dieses Projekt ist für Bildungs-, Forschungs- und Entwicklungszwecke gedacht. Der Autor übernimmt keine Verantwortung für Missbrauch oder unbeabsichtigte Folgen, die durch die Verwendung dieser Software entstehen.