mcp-use + APS 인가 예제

이 독립 실행형 예제는 기존 mcp-use TypeScript 미들웨어 확장 지점 뒤에 Agent Passport System aps-mcp-1 프로필을 배치합니다. 게이트웨이는 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는 독립적인 제3자 프로젝트이며 MCP나 mcp-use의 일부가 아닙니다.