mcp-use + APS 授权示例

此独立示例将 Agent Passport System 的 aps-mcp-1 配置放在现有 mcp-use TypeScript 中间件接缝之后。网关代理 vault_echo 工具，并在 next() 到达上游服务器之前验证已签名的一次性授权信封。

运行

npm install
npm test
npm run dev

打开打印的 URL 以使用内置的 mcp-use Inspector。

1. 使用一条消息调用 issue_aps_demo_grant。

2. 将其结构化结果复制到 vault_echo。

3. 运行 vault_echo；APS 中间件会在分发前验证签名、目标、参数哈希、过期时间、作用域和重放状态。

4. 再次运行相同的请求，观察上游被调用前的重放拒绝。

Related MCP server: SINT Protocol

Inspector 兼容性

APS MCP 配置通常会在以下位置携带其信封：

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

当前的 Inspector 表单不暴露任意的每次调用 _meta。仅用于交互式演示，此仓库接受以 apsAuthorization 工具参数形式传入的相同信封，在中间件内部将其移入带命名空间的 _meta 条目，并在转发前将其移除。生产环境中的 MCP 客户端应直接发送 _meta。

此 localhost 演示还假定传输层认证已经建立。生产代码必须配置 OAuth，并从已验证的传输上下文（ctx.auth）中推断出这一点。

APS 是一个独立的第三方项目，不属于 MCP 或 mcp-use 的一部分。