canton-agent-mcp

Dein Agent fragt. Du genehmigst. Hardware signiert.

Ein MCP-Server, der es einem KI-Agenten ermöglicht, das Canton Network über die mobile Wallet eines Menschen zu nutzen. Der Agent kann anfragen, sich anzumelden und zu bezahlen; jede Anfrage landet als Genehmigungsblatt auf dem Telefon des Menschen, und was signiert wird, wird vom Geräteschlüssel (Secure Enclave oder Android StrongBox) signiert, niemals vom Agenten.

Dieser Server ist ein CIP-0103-dApp-Client über WalletConnect. Er hält keine Schlüssel und keine Ledger-Token. Er kann nur fragen, und der Besitzer der Wallet kann jede Anfrage sehen, genehmigen oder ablehnen.

So funktioniert es

1. Der Agent ruft canton_connect_wallet auf; ein WalletConnect-Pairing-QR erscheint.

2. Der Mensch scannt ihn über den Connect-Tab seiner Wallet und genehmigt auf dem Telefon.

3. Von da an kann der Agent eine Anmeldung (canton_sign_in) oder eine Zahlung (canton_request_payment) anfordern. Jede Anfrage öffnet ein Genehmigungsblatt auf dem Telefon; die Wallet bereitet die Transaktion auf ihrem Teilnehmer vor, verifiziert den Hash der vorbereiteten Transaktion auf dem Gerät erneut und signiert in Hardware.

4. Sitzungen werden auf der Festplatte gespeichert, sodass die Wallet einmal gekoppelt und wiederverwendet wird.

Die Referenz-Wallet auf der anderen Seite ist canton-mobile-app (iOS und Android, basierend auf dem nativen canton-mobile-sdk), aber jede CIP-0103-Wallet, die WalletConnect spricht, funktioniert.

Related MCP server: Grip MCP

Schnellstart

Erfordert Node 22.6+ (der Server führt TypeScript direkt aus, kein Build-Schritt) und eine kostenlose WalletConnect-Cloud-Projekt-ID.

git clone https://github.com/vsima/canton-agent-mcp
cd canton-agent-mcp && npm install

Registriere es bei Claude Code:

claude mcp add canton-agent --env WC_PROJECT_ID=<your-project-id> \
  -- node <path-to>/canton-agent-mcp/src/main.ts

Bitte dann den Agenten, deine Wallet zu verbinden und jemanden zu bezahlen. Eine Zahlungsanfrage blockiert, bis der Mensch entscheidet, also erhöhe das Tool-Timeout deines MCP-Clients, wenn es lange Aufrufe abschneidet (in Claude Code: die Umgebungsvariable MCP_TIMEOUT).

Werkzeuge

Konfiguration

Alles über Umgebungsvariablen:

Zahlungen verwenden standardmäßig ein lokales Splice LocalNet (starte eines über integration/run-localnet.sh im SDK-Repository).

Sicherheitsmodell

• Der Server kann fragen, niemals handeln: keine Schlüssel, keine Ledger-Token, kein Signieren.

• Jede Anmeldung und Zahlung benötigt eine ausdrückliche Genehmigung auf dem Telefon.

• Die Wallet leitet den Hash der vorbereiteten Transaktion auf dem Gerät neu ab und verifiziert ihn, bevor ihr Hardware-Schlüssel signiert, sodass das Telefon nur signieren kann, was es angezeigt hat.

• Anfragen laufen ab (standardmäßig eine Stunde); das Relay speichert sie verschlüsselt.

• Die Ausgabenrichtlinie auf Wallet-Seite (pro Agent begrenzte Beträge und Whitelists, die von der Wallet vor dem Signieren durchgesetzt werden) ist der nächste Meilenstein im nativen SDK.

Entwicklung

npm test        # typecheck + unit tests (no network)
npm run probe   # opens a real relay session and prints the pairing QR

Ein unabhängiges, von der Community erstelltes Open-Source-Projekt, lizenziert unter Apache-2.0. Nicht verbunden mit oder unterstützt von Digital Asset, der Canton Foundation oder der Global Synchronizer Foundation.