awaBerry MCP Server

Verbinden Sie KI-Agenten mit echten Geräten – über das Model Context Protocol.

Geben Sie KI-Agenten Hände – An Ihren tatsächlichen Geräten.

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 mit Claude Desktop — KI-Agent verbindet sich mit einem Remote-Gerät und führt Befehle aus

awaBerry MCP Server integriert mit Claude Desktop — KI-Agent verbindet sich mit einem registrierten Gerät und führt Befehle in Echtzeit aus.

MCP Client

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.

MCP Server Implementierungen

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.

Was KI-Agenten tun können

Die Funktion createMcpServer stellt eine Reihe von Werkzeugen bereit, die KI-Agenten direkt aufrufen:

connect_to_device

Stellt 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_command

Fü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_postgres

Fü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_postgres

Ruft 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.

Zwei Möglichkeiten, den MCP Server auszuführen

JSON / HTTP Server

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

Cloudflare Worker

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.

Claude Desktop (mcpclient)

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.

Zero-Trust-Zugriff für KI-Agenten

Jede Verbindung, die vom MCP Server hergestellt wird, übernimmt das vollständige Sicherheitsmodell der awaBerry Agentic API:

Projektbezogene Anmeldeinformationen

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.

Sofortige Sperrung

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.

In wenigen Minuten einsatzbereit

Voraussetzungen: Node.js und Git. Befolgen Sie dann diese Schritte:

1. Klonen & Installieren

Klonen Sie das Repository von GitHub und installieren Sie die Abhängigkeiten:

git clone https://github.com/awaberry/mcp_server_awaberry
cd mcp_server_awaberry && npm install

2. Erstellen Sie ein Agentic API-Projekt

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.

3. Konfigurieren & Ausführen

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.

Vollständige Dokumentation auf GitHub anzeigen → Entwickler-Dokumentation

Verbinden Sie Ihren KI-Agenten jetzt mit Ihren Geräten.

Open Source. Zero-Trust. In wenigen Minuten einsatzbereit.