Zum Inhalt springen

Architektur: sechs Säulen, Fail-Closed-Pipeline

ToolMesh ist eine Go-Middleware, die die Ausführung von Tool-Calls zwischen KI-Agenten und Backend-Infrastruktur orchestriert, autorisiert und absichert.

Claude CodetrustedClaude Desktoptrusted3rd Party AgentuntrustedMCP + CallerIDToolMeshSelf-hosted MCP gatewayAuthOAuth 2.1AuthZOpenFGACredentialsSecret InjectGateJS PoliciesExecuteMCP / RESTAuditslog / SQLiteMCP ServersHTTP / STDIOAny existing MCP serverDADL LibraryREST APIs described in YAML, one file per APIdadl.aiStripeGitHubHetznerDeepLCloudflareyour REST API4,591 tools across 36 APIs in the registry at dadl.ai

Jeder Tool-Call durchläuft eine Fail-Closed-Pipeline. Wenn ein Schritt ablehnt (AuthZ, Gate), wird die gesamte Ausführung gestoppt. Keine Teilergebnisse gelangen durch.

SäuleImplementierungBasiert auf
Any BackendMCP-Server (HTTP/STDIO) + REST-APIs via DADLGo MCP SDK + DADL-Parser
Code Modediscover_tools + execute_code — LLMs schreiben JS statt JSONAST-geparste Tool-Calls
AuditJeder Tool-Call wird strukturiert protokolliertslog (Write-only) oder SQLite (abfragbar)
AuthorizationStandardmäßig aktiv: Benutzer, Rollen und Pläne erhalten Tools über Presets oder Grants; Koffer geben Rechte für eine Aufgabe dazu, von einem Menschen freigegeben und signiertOpenFGA, eingebaut
Credential StoreSecrets werden zur Laufzeit injiziert, nie in Prompts; jedes Backend liest nur seine eigenen, und die Hosts, an die sie gehen, sind begrenztUmgebungsvariablen (CREDENTIAL_*) oder ein Befehl wie sops, im Arbeitsspeicher gehalten; erweiterbar
Output GateJS-Policies validieren Ein-/Ausgabengoja (Go JS-Engine)

Drei Komponenten sind über ein Registry-Pattern erweiterbar (inspiriert von Go’s database/sql-Treibern):

KomponenteRegistry-FunktionBuilt-inKonfiguration
Credential Storecredentials.Register()embedded (Umgebungsvariablen), command (im Arbeitsspeicher)CREDENTIAL_STORE=<name>
Tool Backendbackend.Register()mcp, rest (DADL), echoconfig/backends.yaml
Gate Evaluatorgate.RegisterEvaluator()goja (JavaScript)GATE_EVALUATORS=<list>

Erweiterungen registrieren sich über init()-Funktionen. Enterprise-Erweiterungen leben in einem separaten Modul und werden über Go Build-Tags eingebunden:

Terminal-Fenster
go build -tags enterprise ./cmd/toolmesh
KomponenteErweiterungBeschreibung
Credential StoreInfisicalStoreInfisical Secrets Manager Integration
Credential StoreVaultStoreHashiCorp Vault / OpenBao Integration
Gate EvaluatorCompliance-LLMLLM-basierte Inhaltsklassifizierung
toolmesh/
├── cmd/
│ └── toolmesh/ # Haupt-Einstiegspunkt (MCP-Server)
├── config/
│ ├── authz.yaml.example # Autorisierungs-Grants (nach authz.yaml kopieren)
│ └── openfga/ # Beispielmodell, Tuples und Setup-Script für einen externen OpenFGA-Server
├── internal/
│ ├── mcp/ # MCP-Server (Streamable HTTP + STDIO)
│ ├── backend/ # ToolBackend-Interface + MCPAdapter + RESTAdapter
│ ├── executor/ # ExecuteTool-Pipeline (AuthZ → Creds → Gate → Exec → Audit)
│ ├── audit/ # Audit-Store-Interface + log/sqlite-Implementierungen
│ ├── authz/ # Autorisierung (eingebettetes oder externes OpenFGA)
│ ├── credentials/ # Credential-Store-Interface, EmbeddedStore, CommandStore
│ ├── gate/ # Output Gate (goja Policy-Engine)
│ ├── userctx/ # UserContext-Propagierung
│ └── config/ # Umgebungsbasierte Konfiguration
├── config/ # Backend-Konfiguration (backends.yaml, users.yaml, apikeys.yaml)
├── tools/ # TypeScript Tool-Definitionen (kanonische Quelle)
├── policies/ # JavaScript Gate-Policies
└── docs/ # Dokumentation