Der Agent bekommt die Tools. ToolMesh behält die Schlüssel.
ToolMesh ist ein MCP-Gateway, das Sie selbst betreiben. Claude, ChatGPT und andere MCP-Clients verbinden sich mit einem Endpoint und rufen Tools von GitHub, NetBox, Stripe, Zammad oder Ihrer eigenen REST-API auf. ToolMesh hält die API-Keys, prüft bei jedem Aufruf, ob der Aufrufer ihn machen darf, und schreibt jeden Aufruf in ein Audit-Log.
REST-APIs kommen über DADL-Dateien herein, wenige Zeilen YAML pro Endpoint, die ein LLM für Sie schreiben kann. Bestehende MCP-Server, über HTTP oder stdio, hängen hinter demselben Endpoint.
4.591 Tools aus 36 APIs in der DADL-RegistryAPI-Keys bleiben auf dem ServerAutorisierung ab Werk aktivEin Audit-Eintrag für jeden AufrufREST-APIs und MCP-ServerApache 2.0Self-hosted
Heute in der Registry
36 APIs, die schon als DADL-Datei beschrieben sind.
4.591Tools
Ein Tool ist eine API-Aktion: ein Repo auflisten, eine Rechnung anlegen, einen Server neu starten. Jedes Backend ist eine YAML-Datei; ToolMesh stellt sie alle hinter einem Endpoint bereit.
Ein MCP-Client, der mit fünf Systemen spricht, hat meist fünf API-Keys in seiner Konfiguration, und jeder Agent, der den Client nutzt, darf jedes Tool aufrufen, das diese Keys öffnen. Ein MCP-Server bietet die Endpoints, die sein Autor ausgewählt hat; brauchen Sie einen weiteren, warten Sie auf ein Release oder forken den Server. Und wenn ein Agent etwas Unerwartetes getan hat, bleibt die Frage „Welches Tool hat er aufgerufen, mit welchen Parametern?“ oft ohne Antwort.
ToolMesh legt die Keys, die Berechtigungen und das Protokoll der Aufrufe in einen Dienst, den Sie selbst betreiben.
Was Sie bekommen
🔌
Ein Endpoint für viele Backends
REST-APIs über DADL-Dateien und bestehende MCP-Server über HTTP oder stdio. Tools heißen <backend>_<tool>, zum Beispiel github_list_issues.
🔑
API-Keys bleiben auf dem Server
ToolMesh liest sie aus seiner Umgebung oder aus einem Kommando, etwa einer sops-Entschlüsselung, und setzt sie beim Aufruf in die Anfrage ein. Die Keys stehen weder in Prompts noch in der Client-Konfiguration.
🔐
Autorisierung ab dem ersten Start
OpenFGA läuft in ToolMesh mit. Grants nennen Benutzer, Rollen, Pläne oder Firmen und erlauben alle Tools, ein Backend, einzelne Tools oder eine Zugriffsklasse wie read. Tool-Listen zeigen jedem Aufrufer nur, was er aufrufen darf.
📋
Ein Audit-Eintrag für jeden Aufruf
Wer welches Tool mit welchen Parametern aufgerufen hat, wie lange es dauerte und wie es ausging. Ab Werk als strukturierte Log-Zeilen; mit AUDIT_STORE=sqlite in einer Datenbank, die Sie mit SQL abfragen.
💻
Code Mode
Das Modell sieht zwei Tools, discover_tools und execute_code, schlägt die Signaturen nach, die es braucht, und schreibt kurzes JavaScript, das mehrere Aufrufe in einem Durchgang macht. Im DADL-Paper kostete das Ankündigen von 1.833 Tools rund 142.000 Tokens; die zwei Code-Mode-Tools kosten rund 1.000.
🛡️
Optionale JavaScript-Policies
Eine Policy prüft einen Aufruf, bevor er läuft, und filtert sein Ergebnis, etwa um personenbezogene Daten zu schwärzen. Aktiv ist keine, bis Sie eine hinzufügen; Beispiele liegen ToolMesh bei.
Aus einer REST-API werden Tools, mit wenigen Zeilen YAML pro Endpoint.
Eine DADL-Datei beschreibt eine REST-API als MCP-Tools. Die Datei legt auch fest, wie sich die API authentifiziert (Bearer-Token, API-Key, OAuth2, Session-Login), wie sie blättert und wann wiederholt wird. Die HTTP-Arbeit macht ToolMesh.
Prompt„Erstelle ein DADL für die Hetzner Cloud API: Server auflisten, Server anlegen, Server löschen“
→
ErgebnisEine hetzner-cloud.dadl mit drei Tools. Testen Sie die Datei gegen die echte API, bevor Sie sich auf sie verlassen.
Die DADL-Registry hat Beschreibungen für 36 APIs. Für andere fragen Sie ein LLM, das die DADL-Spec kennt. ToolMesh prüft ein DADL nicht, das ein LLM geschrieben hat; probieren Sie neue Tools deshalb zuerst mit einem Wegwerf-Account oder mit Testdaten aus.
Vier APIs als vier MCP-Server, und dieselben vier als DADL-Dateien hinter ToolMesh:
MCP-Server
Bestehende MCP-Server hängen hinter demselben Endpoint.
ToolMesh läuft auch ohne DADL. Tragen Sie einen MCP-Server, den Sie schon betreiben, inconfig/backends.yaml ein, über HTTP oder stdio, und seine Tools laufen durch dieselbe Autorisierung, dieselbe Credential-Verwaltung, dieselben Policies und dasselbe Audit-Log.
Die DADL-Spezifikation steht unter CC BY-SA 4.0. Eigene Dateien schreiben, in Git versionieren, teilen, forken.
Dateien auf Ihrem eigenen Server.
ToolMesh liest .dadl-Dateien aus seinem Verzeichnis dadl/. Die tägliche Nutzungsstatistik enthält von jeder Datei nur einen Hash, und eine Zeile in der .env schaltet sie ab.
Keine Laufzeit-Abhängigkeit von dadl.ai.
dadl.ai ist ein Katalog, aus dem Sie Dateien kopieren können. ToolMesh ruft ihn zur Laufzeit nicht auf. Spiegeln Sie die Dateien oder schreiben Sie eigene.
Optional.
ToolMesh läuft auch nur mit MCP-Servern. DADL ist einer von zwei Wegen hinein.
Policies können unterscheiden, welcher Client aufruft.
Ein API-Key in der apikeys.yaml kann eine Caller-ID tragen, ein OAuth-Client wird an seiner Client-ID erkannt. config/caller-classes.yaml ordnet Caller-IDs Klassen zu; eine ID, die auf kein Muster passt, ist untrusted. Policies lesen die Klasse. Die Beispiel-Policy pii_protection.js maskiert je Klasse wie unten gezeigt. Die Policy ist inaktiv, bis Sie sie nach config/policies/ kopieren.
Caller-Klasse
Was pii_protection.js in einem Ergebnis maskiert
trusted
AWS-Keys und API-Tokens
standard
Kreditkartennummern, US-Sozialversicherungsnummern, AWS-Keys und API-Tokens
untrusted und jede andere Klasse
Alles Genannte, dazu E-Mail-Adressen, Telefonnummern und IPv4-Adressen
Ein Mensch gibt die Rechte für eine Aufgabe frei. Und signiert die Freigabe.
Grants decken die tägliche Arbeit ab. Für die Aufgabe, die mehr braucht, fragt ein Agent nach einem Koffer: ein benanntes Bündel von Tools mit Zeitlimit, von Ihnen in config/authz.yaml definiert. Aus der Anfrage wird ein Link. Wer freigibt, signiert ein Statement mit genau dem, was freigegeben wird, mit einem Schlüssel, der den Browser nie verlässt. ToolMesh prüft die Signatur, behält sie mit dem Statement im Audit-Trail, und der Grant endet von selbst.
Der Agent fragt einmal.tell_me_my_rights nennt die Tools, die einer Aufgabe fehlen, und den Koffer, der sie abdeckt; request_grant antwortet mit Link und Fingerprint, auch aus execute_code heraus.
Die Freigabe ist eine Signatur des Freigebenden.Ein Klartext-Statement (BIP-322) nennt Anfrage, freigegebene Einträge, Dauer und Anforderer. ToolMesh kennt die Adresse, nie den Schlüssel. Teile eines Koffers freigeben, oder für kürzere Zeit.
Der Audit-Trail behält den Beleg.Adresse, Signatur und Statement jeder Freigabe, und zu jedem Aufruf unter einem Koffer, welcher Koffer galt und welche Gate-Policies er ersetzt hat. Später prüfbar für jeden mit dem Log.
Wo es endet.Ein Grant läuft ab oder wird widerrufen. Denies in authz.yaml gewinnen gegen jeden Koffer, und Parameterfilter mit enforce-with-kit laufen weiter.
Verbinden Sie Claude Desktop, Claude Code oder ChatGPT mit der öffentlichen Demo unter demo.toolmesh.io. Die Demo bedient zwei Hacker-News-Backends und braucht keinen API-Key von Ihnen. Der Login ist dadl / toolmesh.
Hosted Demo öffnenEine Demo-Instanz. Für Ihre eigenen Systeme betreiben Sie ToolMesh selbst.
Self-host
Eigene Instanz betreiben.
Sie brauchen Docker mit Docker Compose und einen freien Port, ab Werk 8123. Claude Code verbindet sich auf localhost über einfaches HTTP. Claude Desktop, claude.ai und die meisten anderen Clients nehmen nur HTTPS-URLs an und brauchen deshalb einen Reverse Proxy mit TLS vor ToolMesh. Die Schritte unten enden mit einem ersten Tool-Aufruf und nutzen das Hacker-News-DADL, das ToolMesh beiliegt.
1
Repository klonen
git clone https://github.com/DunkelCloud/ToolMesh.git && cd ToolMesh
2
.env anlegen und einen API-Key setzen
cp .env.example .env
Setzen Sie in der .env den Wert TOOLMESH_API_KEY, zum Beispiel auf die Ausgabe von openssl rand -hex 32. Ohne Passwort oder API-Key lehnt ToolMesh jede Anfrage ab.
Speichern Sie das als config/backends.yaml. Die Hacker-News-API braucht keinen Key.
4
ToolMesh starten und prüfen, ob es antwortet
docker compose up -d
curl http://localhost:8123/health
5
Claude Code verbinden
claude mcp add -t http -H "Authorization: Bearer <YOUR_API_KEY>" -s user toolmesh http://localhost:8123/mcp
6
Fragen: „Was sind gerade die Top-Stories auf Hacker News?“Claude Code ruft hackernews_get_top_stories über ToolMesh auf, und der Audit-Eintrag erscheint in docker compose logs toolmesh.
Es terminiert kein TLS. ToolMesh spricht einfaches HTTP; für alles jenseits von localhost gehört ein Reverse Proxy davor.
Es hält die Keys der Backends. Jeder Client meldet sich weiterhin bei ToolMesh an, mit OAuth oder mit einem API-Key, der in seiner Konfiguration steht.
Es setzt keine Policy durch, bis Sie eine hinzufügen. Die mitgelieferten Beispiele bleiben inaktiv.
Das Audit-Log ist ab Werk nur zum Schreiben. Vergangene Aufrufe mit SQL zu durchsuchen braucht AUDIT_STORE=sqlite.
Es spricht REST über DADL und MCP. Andere Protokolle wie gRPC, SOAP oder direkter Datenbankzugriff brauchen einen MCP-Server davor.
Es prüft kein DADL, das ein LLM geschrieben hat. Testen Sie neue Tools gegen die echte API, am besten mit einem Wegwerf-Account oder mit Testdaten.
Ein execute_code-Skript macht höchstens 50 Tool-Aufrufe und läuft höchstens 120 Sekunden (TOOLMESH_CODE_TIMEOUT).
Für Plattform-Teams
ToolMesh und DADL als Enterprise Tool Library
MCP legt fest, wie ein Agent mit einem Tool spricht. Ein Unternehmen mit einem vierstelligen Katalog von Tools über viele Backends braucht außerdem eine Stelle für Zugriffsregeln, einen Audit-Trail und ein Beschreibungsformat, das in Git liegt. DasDADL-Paper nennt das eine Enterprise Tool Library. ToolMesh und DADL sind ein offener, selbst gehosteter Weg, eine zu bauen.
ProjektstatusOpen Source · aktiv entwickelt · Version 0.xToolMesh läuft bei Dunkel Cloud produktiv. Ein Minor-Release kann die Konfiguration noch ändern; die Upgrade-Hinweise nennen, was ein Betreiber anpassen muss.
BetreiberEntwickelt von Dunkel Cloud GmbHDeutsches Cloud-Engineering-Unternehmen. Fragen oder kommerzieller Support: Kontakt.
PreisOpen Source & self-hosted heute.Managed Service ist geplant, aber nicht angekündigt. Keine kostenpflichtigen Features, keine „Enterprise Edition" heute.
TelemetrieAnonyme Nutzungsstatistik, einmal am Tag.Eine zufällige Site-ID, der Hash jeder DADL-Datei, Aufruf- und Fehlerzahlen je DADL, die Zahl der MCP-Backends und die Version. Keine Benutzer-IDs, Keys, Parameter, URLs oder Anfrageinhalte. DO_NOT_SEND_ANONYMOUS_STATISTICS=yes schaltet sie ab. Details →
ForschungDas Design ist in einem Paper dokumentiert.DADL und die Token-Messung zu Code Mode (von rund 142.000 auf rund 1.000 bei 1.833 Tools) sind auf arXiv (cs.SE) beschrieben und auf Zenodo mit DOI archiviert.