Verbinden Sie KI-Agenten mit echten Geräten – über das Model Context Protocol.
Der awaBerry MCP Server ist eine Open-Source-Implementierung des Model Context Protocol (MCP), die KI-Agenten direkt mit Ihren registrierten awaBerry-Geräten verbindet. Ob Sie Claude Desktop, eine benutzerdefinierte agentische Pipeline oder ein beliebiges MCP-kompatibles Werkzeug verwenden, der awaBerry MCP Server ermöglicht es Agenten, sich mit echten Maschinen zu verbinden, Terminalbefehle auszuführen, mit Datenbanken zu interagieren und Dateien zu übertragen – alles gesichert durch die awaBerry Zero-Trust Agentic API.
awaBerry MCP Server integriert mit Claude Desktop — KI-Agent verbindet sich mit einem registrierten Gerät und führt Befehle in Echtzeit aus.
Verbindet sich mit Claude Desktop und anderen MCP-kompatiblen KI-Umgebungen. Authentifizieren Sie sich mit einem Projekt-Schlüssel und -Geheimnis, und lassen Sie Ihren KI-Agenten sich mit Geräten verbinden, Sitzungen verwalten und Befehle mit natürlicher Sprache oder direkten Tool-Aufrufen ausführen.
Zwei Bereitstellungsmodi: ein JSON/HTTP-Server für Unternehmensintranets und Cloud-Infrastrukturen (Express.js, /mcp POST-Endpunkt) und eine Cloudflare Worker-Bereitstellung für global verteilte, Firewall-umgehende Fernsteuerung – kein VPN, keine offenen Ports erforderlich.
Die Funktion createMcpServer stellt eine Reihe von Werkzeugen bereit, die KI-Agenten direkt aufrufen:
connect_to_deviceStellt eine persistente, sichere Terminal-Sitzung auf jedem registrierten awaBerry-Gerät her. Der Agent authentifiziert sich über Projekt-Schlüssel und -Geheimnis – keine SSH-Schlüssel, keine Firewall-Änderungen. Die Verbindung wird über die ausgehende Zero-Trust-Infrastruktur von awaBerry vermittelt.
execute_terminal_commandFührt jeden Shell-Befehl auf dem verbundenen Gerät aus und empfängt die Ausgabe direkt im Kontext des Agenten zurück. Unterstützt langlaufende Befehle, Skriptausführung, Dateiverwaltung und vollständige Shell-Interaktion – alles innerhalb der Berechtigungsgrenzen, die Sie in Ihrem Agentic API-Projekt definiert haben.
execute_database_command_postgresFührt beliebige SQL-Anweisungen gegen eine PostgreSQL-Datenbank aus, die auf dem verbundenen Gerät läuft. Ideal für KI-gesteuerte Datenaggregation, Berichterstattung und Analyse-Pipelines, die Live-Strukturdaten vom Edge benötigen.
describe_database_schema_postgresRuft das vollständige Schema einer PostgreSQL-Datenbank ab – Tabellen, Spalten, Typen und Beziehungen –, damit der KI-Agent den Datensatz verstehen kann, bevor er präzise Abfragen oder Transformationen erstellt.
Führen Sie den MCP Server als Express.js HTTP-Dienst auf Ihrer eigenen Infrastruktur aus – innerhalb eines Unternehmensintranets, einer privaten Cloud oder eines dedizierten Servers. KI-Agenten verbinden sich über den /mcp POST-Endpunkt damit. Ideal für Teams mit bestehender Infrastruktur, die die volle Kontrolle über die Bereitstellungsumgebung wünschen.
npm run start:mcp:json
Stellen Sie den MCP Server als Cloudflare Worker für einen global verteilten, serverlosen Endpunkt bereit. Der Worker verarbeitet eingehende MCP-Anfragen, verwaltet Sitzungen mit agentic.awaberry.net und leitet Befehle an Ihre Geräte weiter – ohne dass offene Firewall-Ports oder ein dedizierter Server erforderlich sind.
Siehe cloudflare/worker/awaberrymcpserver/ im Repository.
Konfigurieren Sie den mcpclient direkt in der MCP-Konfiguration von Claude Desktop. Ihre KI-Konversationen erhalten die Fähigkeit, sich mit Ihren Geräten zu verbinden, Befehle auszuführen und Daten zu lesen oder zu schreiben – über natürliche Sprache, angetrieben durch Claudes Denkvermögen und die sichere Gerätezugriffsschicht von awaBerry.
Siehe mcpclient/ im Repository.
Jede Verbindung, die vom MCP Server hergestellt wird, übernimmt das vollständige Sicherheitsmodell der awaBerry Agentic API:
KI-Agenten authentifizieren sich mit einem Projekt-Schlüssel und -Geheimnis, das an ein bestimmtes Agentic API-Projekt gebunden ist. Das Projekt definiert genau, welche Geräte zugänglich sind, auf welchem Berechtigungsniveau, mit welchen Dateisystempfaden und mit welcher Befehls-Whitelist. Der Agent kann nur das tun, was das Projekt erlaubt – nicht mehr.
Löschen Sie das Agentic API-Projekt und jede aktive MCP-Sitzung wird sofort beendet. Keine Restanmeldeinformationen, keine Bereinigungsskripte. Die Sperrung ist sofortig und vollständig – entscheidend für temporäre KI-Workloads, einmalige Analyseaufgaben oder den Zugriff externer Mitarbeiter.
Voraussetzungen: Node.js und Git. Befolgen Sie dann diese Schritte:
Klonen Sie das Repository von GitHub und installieren Sie die Abhängigkeiten:
git clone https://github.com/awaberry/mcp_server_awaberrycd mcp_server_awaberry && npm install
Navigieren Sie in Ihrem awaBerry-Dashboard zu /agentic, erstellen Sie ein neues Projekt, wählen Sie Ihre Zielgeräte aus, aktivieren Sie Programmatischer Zugriff und konfigurieren Sie den Berechtigungsumfang. Kopieren Sie den generierten Projekt-Schlüssel und das Geheimnis.
Legen Sie Ihren projectKey, projectSecret und deviceName als Umgebungsvariablen fest (oder in Ihrer Claude Desktop MCP-Konfiguration). Starten Sie den Server mit npm run start:mcp:json (HTTP) oder konfigurieren Sie den stdio-Client für Claude Desktop. Ihr KI-Agent ist nun verbunden.
Automatisieren Sie Abläufe, verwalten Sie Geräteflotten und ermöglichen Sie sicheres Remote-Arbeiten für Ihr gesamtes Team.
Greifen Sie auf Ihre Heimgeräte zu, automatisieren Sie persönliche Aufgaben und teilen Sie den Zugriff mit der Familie — kostenlos.
Greifen Sie auf Labor-Hardware zu, automatisieren Sie Datenerfassung und arbeiten Sie institutionsübergreifend zusammen.
Open Source. Zero-Trust. In wenigen Minuten einsatzbereit.