mcp-l402-gate-example

Minimaler MCP-Server, der @powforge/mcp-l402-gate in Aktion zeigt.

Ein Tool, bitcoin_data, ruft den aktuellen BTC/USD-Preis sowie empfohlene Mempool-Gebühren von mempool.space ab. Jeder Aufruf ist wie folgt geschützt:

1. Eine L402 Lightning-Rechnung (der Aufrufer zahlt Sats pro Aufruf).

2. Eine Depth-of-Identity-Score-Abfrage gegen das öffentliche PowForge-Orakel. Unterhalb des Schwellenwerts gewährt die Zahlung keinen Zugriff.

L402 allein beweist, dass ein Aufrufer bezahlt hat. L402 + DoI beweist, dass er bezahlt hat und eine Reputationsbewertung pro Pubkey besitzt, die über Sitzungen hinweg Bestand hat und deren Fälschung irreversible Arbeit erfordert. Dieser zweite Teil ist der Aspekt, den die meisten MCP-Abrechnungs-Kits auslassen.

Schnellstart

git clone https://github.com/zekebuilds-lab/mcp-l402-gate-example
cd mcp-l402-gate-example
cp .env.example .env       # fill in GATE_HMAC_SECRET and LNBits creds
npm install
npm start

Der Server protokolliert beim Start die Tool-URL und das Orakel. Der Standard-Port ist 3100.

Related MCP server: l402-kit-mcp

Testen mit curl

Der erste Aufruf hat keine Authentifizierung, daher gibt das Gate einen 402-Fehler mit einer Rechnung zurück:

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -d '{}'

Erwartete Antwort:

HTTP/1.1 402 Payment Required
WWW-Authenticate: L402 macaroon="...", invoice="lnbc1..."
Content-Type: application/json

{
  "error": "payment required",
  "macaroon": "...",
  "invoice": "lnbc1...",
  "payment_hash": "..."
}

Bezahlen Sie das Feld invoice (mit einer beliebigen LN-Wallet), erfassen Sie das Preimage und versuchen Sie es erneut:

curl -i -X POST http://localhost:3100/tools/bitcoin_data \
  -H 'Content-Type: application/json' \
  -H 'X-Caller-Pubkey: 02a1b2c3...your-hex-pubkey' \
  -H 'Authorization: L402 <macaroon>:<preimage>' \
  -d '{}'

Sie erhalten den BTC-Preis, die Schätzungen für die Mempool-Gebühren und den DoI-Score des Aufrufers zurück.

Das Manifest wird ebenfalls für MCP-Clients bereitgestellt, die Tool-Kataloge untersuchen:

curl http://localhost:3100/manifest.json

Konfiguration

DoI-Score-Schwellenwerte

Dies sind dieselben Kategorien, die das Orakel als rank zurückgibt. Wählen Sie diejenige, die dazu passt, wie teuer ein falscher Aufruf ist:

Funktionsweise des Gates

Ohne das Gate beweist ein 402 + Macaroon-Flow, dass der Aufrufer 10 Sats bezahlt hat. Eine neue Angreifer-Wallet zahlt dieselben 10 Sats. Das ist ein korrektes Wire-Format, aber ein schwacher Schutz gegen Missbrauch.

@powforge/mcp-l402-gate behält die L402-Rechnung bei und fügt eine zweite Prüfung hinzu: Wenn das Macaroon verifiziert ist, ruft das Gate das DoI-Orakel für den Pubkey des Aufrufers ab, erhält einen Schnorr-signierten Score zurück und vergleicht ihn mit MIN_SCORE. Der Score setzt sich aus beobachtbarer, irreversibler Arbeit in vier Dimensionen zusammen (sozial, Zugriff, Bürgschaft, wirtschaftlich), sodass ein neuer Sybil-Angreifer ihn nicht in einer Minute manipulieren kann.

Die vollständige Tabelle der Fehlermodi finden Sie in der @powforge/mcp-l402-gate README.

Dateien

• server.js - der MCP-Server, ca. 110 Zeilen.

• .env.example - kopieren Sie diese nach .env und füllen Sie sie aus.

• package.json - abhängig von express und @powforge/mcp-l402-gate.

Links

• npm: @powforge/mcp-l402-gate

• Dokumentation und Preise: powforge.dev/mcp

• Öffentliches DoI-Orakel: identity.powforge.dev

Lizenz

MIT.