Open-Source-Projekt mit ESP32-CAM

Gizmo Camera

WLAN-Kamera mit ESP32-CAM, die bei jeder Anfrage ein JPEG-Foto macht, mit Web-App für die Einrichtung per Smartphone und einem MCP-Server für KI-Agenten.

  • JPEG-Fotos bis 1600 × 1200
  • Einfache HTTP-API
  • MCP-Server für KI-Agenten
Schwierigkeit
Einsteiger
Bauzeit
15 Min.
Löten
Ohne Löten
Die Gizmo Camera in ihrem weiß-orangen gedruckten Gehäuse auf dem Kugelgelenk-Ständer, und zerlegt in die Schale, die ESP32-CAM auf ihrem MB-Board, die Rückplatte, vier M3-Schrauben und den Ständer.

Das Projekt im Überblick

Ein schneller Überblick über Hardware, Firmware und Verhalten dieses Builds.

Kamera

01

Der OV2640-Sensor und die weiße Blitz-LED der AI-Thinker-ESP32-CAM, mit Fotos von 160 × 120 bis 1600 × 1200 und einstellbarer JPEG-Qualität.

HTTP-API

02

Jedes Foto ist eine GET-Anfrage an /api/capture, die ein JPEG zurückgibt, mit Auflösung, Qualität und Blitz als Optionen. So können Browser, Skripte und Smarthome-Server sie gleichermaßen nutzen.

KI-Agenten

03

Ein MCP-Server unter /mcp lässt Agenten wie Claude Code mit dem Tool take_snapshot durch die Kamera schauen, und eine Markdown-Anleitung unter /llms.txt erklärt, wie man ihn benutzt.

Einrichtung

04

Flashen im Browser, dann Einrichtung über einen Hotspot beim ersten Start, mit lokalem Zugriff über gizmo-camera.local in unterstützten Netzwerken. Kein Code zum Anpassen und keine Zugangsdaten in der Firmware.

Überblick

Gizmo Camera gibt einem günstigen ESP32-CAM-Modul einen richtigen Job: eine Kamera in deinem Netzwerk, die jede Anfrage mit einem frischen Foto beantwortet. Richte sie auf einen 3D-Drucker, eine Pflanze oder eine Tür, und alles, was eine HTTP-Anfrage stellen kann, sieht, was sie sieht. KI-Agenten bekommen sie als MCP-Server, also können auch sie damit sehen, was vor der Kamera passiert.

  • JPEG-Fotos auf Anfrage, mit dem OV2640 bis zu 1600 × 1200, und die Blitz-LED für dunkle Szenen
  • Eine in die Firmware eingebaute Web-App, um die Kamera einzurichten und per Smartphone Fotos zu machen
  • Eine kleine HTTP-API, die Skripte und andere Geräte direkt aufrufen können
  • Ein MCP-Server und eine Markdown-Anleitung, damit KI-Agenten die Kamera selbstständig nutzen können

So funktioniert es

Jedes Foto, egal wer es anfordert, nimmt denselben kurzen Weg.

SchrittWas passiert
AnfrageDie Web-App, ein Skript oder ein beliebiger HTTP-Client ruft /api/capture mit Auflösung, Qualität und Blitz auf. Ein KI-Agent fordert dasselbe an, indem er take_snapshot auf dem MCP-Server aufruft.
AufnahmeDie Firmware wendet die Optionen auf den Sensor an, schaltet bei Bedarf den Blitz ein und nimmt ein frisches Bild auf.
SendenDas JPEG wird direkt aus dem Speicher der Kamera an den Client gestreamt, mit Auflösung und Aufnahmezeit in den Antwort-Headern.

Die Kamera macht immer nur ein Foto auf einmal: Eine Anfrage, die eintrifft, während gerade ein anderes Foto entsteht, bekommt eine klare Antwort, dass die Kamera beschäftigt ist, und kann es einfach einen Moment später noch einmal versuchen.

Wofür sie taugt

Gizmo Camera macht aus ein paar Euro Hardware eine Kamera, die Menschen, Skripte und KI-Agenten auf dieselbe Weise nutzen können. Sie ist außerdem eine kompakte Vorlage für jedes ESP32-Gerät, das sich leicht per Code ansprechen lassen soll.

  • Schau dir einen Druck, eine Pflanze oder eine Tür vom Smartphone aus an, ohne App und ohne Cloud-Konto.
  • Hol dir Fotos aus Skripten und Smarthome-Systemen mit einer einzigen HTTP-Anfrage.
  • Gib einem KI-Agenten Augen für die physische Welt, in deinem eigenen Netzwerk.

Die Web-App

Das siehst du auf dem Handy, sobald das Gerät in deinem WLAN ist.

Der Kamera-Bildschirm der Web-App mit dem letzten Foto (ein Testbild in 1600 × 1200), seiner Größe und der Aufnahmezeit sowie den Schaltflächen, um ein neues Foto zu machen und zu speichern.
Der Kamera-Bildschirm vor dem ersten Foto, mit der Schaltfläche zum Fotografieren und den Optionen für Auflösung und Qualität.
Der WLAN-Bildschirm mit dem aktuellen Netzwerk und den Netzwerken in Reichweite.

Was du brauchst

Die Teile, die du vor dem Start besorgen solltest, und worauf du beim Kauf achten musst.

  • 1×

    AI-Thinker-ESP32-CAM

    Mit der OV2640-Kamera und den 4 MB PSRAM, die die Firmware braucht: Jedes AI-Thinker-Modul hat beides.

  • 1×

    USB-Board ESP32-CAM-MB

    Der USB-Adapter, auf den die ESP32-CAM gesteckt wird, zum Flashen und zur Stromversorgung: Die ESP32-CAM hat keinen eigenen USB-Anschluss.

  • 1×

    Micro-USB-Datenkabel

    Ein Datenkabel, kein reines Ladekabel, an einem guten USB-Anschluss oder einem 5-V-Netzteil: Die Blitz-LED und das WLAN ziehen Stromspitzen.

Einrichtung

Mit diesen Schritten bringst du das Projekt zum Laufen, von der ersten lokalen Einrichtung bis zum ersten Upload oder zur Konfiguration.

  1. 01

    Schritt 1

    Steck die ESP32-CAM auf ihr MB-Board und verbinde sie per USB

    Die ESP32-CAM hat keinen eigenen USB-Anschluss: Steck sie auf ihr USB-Board ESP32-CAM-MB und verbinde es mit einem USB-Datenkabel mit deinem Computer. Nutze Chrome oder Edge, damit der Flasher im Browser ihren seriellen Port findet.

  2. 02

    Schritt 2

    Flashe die fertige Firmware von dieser Seite

    Scrolle nach unten zum Firmware-Flasher, starte den Upload im Browser und warte, bis er fertig ist. Wenn der Flasher keine Verbindung bekommt, halte IO0 auf dem MB-Board gedrückt, drücke und lass RST los, lass dann IO0 los und versuch es noch einmal. Wenn alles durch ist, drücke RST, um die neue Firmware zu starten.

  3. 03

    Schritt 3

    Verbinde die Kamera mit deinem WLAN

    Verbinde dein Smartphone beim ersten Start mit dem Hotspot Gizmo-Camera und wähle auf der Seite, die sich öffnet, dein Netzwerk. Das WLAN wird auf dem Board gespeichert, nie in der Firmware.

  4. 04

    Schritt 4

    Öffne gizmo-camera.local und mach ein Foto

    Sobald sich die Kamera mit deinem WLAN verbunden hat, öffne gizmo-camera.local oder ihre IP-Adresse, wähle Auflösung, Qualität und Blitz und mach ein Foto. Speichere es als JPEG oder hol dir eins per Skript mit einer einfachen HTTP-Anfrage.

    Terminal
    curl -o photo.jpg "http://gizmo-camera.local/api/capture?resolution=SVGA"

Häufige Fragen

Ein paar praktische Antworten dazu, wie das Projekt funktioniert, wie es eingerichtet wird und was du von der Hardware erwarten kannst.

Für alles, wonach du ab und zu schauen willst: einen 3D-Drucker, eine Pflanze, eine Tür oder einen Parkplatz. Sie macht jedes Mal ein frisches Foto, wenn jemand eins anfordert: über die Web-App, ein Skript, einen Smarthome-Server oder einen KI-Agenten.

Quellcode

Gizmo Camera auf GitHub ansehen

Im Repository findest du die Firmware, Hardware-Notizen und die Implementierungsdetails hinter diesem Build.

GitHub öffnen
Illustration zum OpenGizmo-Projekt auf GitHub
Open Source

Siehe auch

Weitere Open-Source-Builds mit dem ESP32 für dein nächstes Projekt.