mcp-use + APS-Autorisierungsbeispiel

Dieses eigenständige Beispiel platziert das Profil aps-mcp-1 des Agent Passport System hinter der vorhandenen mcp-use-TypeScript-Middleware-Nahtstelle. Ein Gateway fungiert als Proxy für ein vault_echo-Tool und verifiziert eine signierte, einmal verwendbare Autorisierungs-Envelope, bevor next() den vorgelagerten Server erreichen kann.

Ausführen

npm install
npm test
npm run dev

Öffnen Sie die ausgegebene URL, um den integrierten mcp-use-Inspector zu verwenden.

1. Rufen Sie issue_aps_demo_grant mit einer Nachricht auf.

2. Kopieren Sie das strukturierte Ergebnis in vault_echo.

3. Führen Sie vault_echo aus; die APS-Middleware verifiziert die Signatur, das Ziel, den Argument-Hash, das Ablaufdatum, den Gültigkeitsbereich und den Replay-Status vor der Weiterleitung.

4. Führen Sie dieselbe Anfrage erneut aus, um die Replay-Ablehnung zu sehen, bevor der vorgelagerte Server aufgerufen wird.

Related MCP server: auth0-3lo-mcp-server

Inspector-Kompatibilität

Das APS-MCP-Profil trägt seine Envelope normalerweise an folgender Stelle:

tools/call.params._meta["org.agent-passport/authorization"]

Das aktuelle Inspector-Formular legt beliebige _meta-Einträge pro Aufruf nicht offen. Nur für die interaktive Demonstration akzeptiert dieses Repository die identische Envelope als Tool-Argument apsAuthorization, verschiebt sie in der Middleware in den namensräumlichen _meta-Eintrag und entfernt sie vor der Weiterleitung. Ein Produktions-MCP-Client sollte _meta direkt senden.

Dieses localhost-Demo behandelt die Transportauthentifizierung ebenfalls als bereits etabliert. Produktionscode muss OAuth konfigurieren und diese Tatsache aus dem verifizierten Transportkontext (ctx.auth) ableiten.

APS ist ein unabhängiges Drittanbieterprojekt und ist nicht Teil von MCP oder mcp-use.