mcp-use + APS: ejemplo de autorización

Este ejemplo independiente coloca el perfil aps-mcp-1 de Agent Passport System detrás del punto de integración de middleware TypeScript existente de mcp-use. Una pasarela actúa como proxy de la herramienta vault_echo y verifica un sobre de autorización firmado y de un solo uso antes de que next() pueda llegar al servidor ascendente.

Ejecución

npm install
npm test
npm run dev

Abra la URL impresa para usar el Inspector integrado de mcp-use.

1. Llame a issue_aps_demo_grant con un mensaje.

2. Copie su resultado estructurado en vault_echo.

3. Ejecute vault_echo; el middleware de APS verifica la firma, el destino, el hash de los argumentos, la caducidad, el alcance y el estado de repetición antes del envío.

4. Ejecute la misma solicitud de nuevo para ver el rechazo por repetición antes de que se llame al servidor ascendente.

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

Compatibilidad con el Inspector

El perfil MCP de APS normalmente lleva su sobre en:

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

El formulario actual del Inspector no expone un _meta arbitrario por llamada. Solo para demostración interactiva, este repositorio acepta el mismo sobre en el argumento apsAuthorization de la herramienta, lo mueve a la entrada _meta con espacio de nombres dentro del middleware y lo elimina antes de reenviarlo. Un cliente MCP de producción debería enviar _meta directamente.

Esta demostración de localhost también trata la autenticación de transporte como ya establecida. El código de producción debe configurar OAuth y deducir ese hecho a partir del contexto de transporte verificado (ctx.auth).

APS es un proyecto independiente de terceros y no forma parte de MCP ni de mcp-use.