Rust 및 AWS Lambda를 활용한 OAuth 기반 MCP 서버 구현 가이드

핵심 기술

이 글은 Rust와 AWS Lambda를 활용하여 OAuth 2.0으로 보안이 적용된 MCP(Message Communication Protocol) 서버를 구축하는 방법을 상세히 안내합니다. 특히, 별도의 ID 공급자(WorkOS)와 연동하여 인증 및 인가 로직을 분리하고, API Gateway를 통해 서버리스 환경에서 효율적으로 관리하는 아키텍처를 제시합니다.

기술적 세부사항

• 아키텍처 개요: API Gateway를 중심으로 권한 부여 브릿지(WorkOS 연동)와 MCP 서버 로직을 별도의 Lambda 함수로 분리하는 서버리스 아키텍처를 채택합니다.
• 권한 부여 로직: Lambda Authorizer를 사용하여 API Gateway에서 요청의 권한을 사전 검증합니다. MCP 리소스 서버는 인가 로직을 알 필요 없이 순수하게 서비스 로직에만 집중합니다.
• MCP 서버 구현: Rust의 axum 웹 프레임워크를 사용하여 MCP 리소스 서버를 구현합니다. Lambda Web Adapter를 통해 AWS Lambda 환경에서 실행됩니다.
• ID 공급자 연동: WorkOS와 같은 외부 ID 공급자를 사용하여 OAuth 인증 흐름을 처리합니다.
• 메타데이터 검색: MCP 사양에 따라 /.well-known/oauth-authorization-server 엔드포인트를 구현하여 클라이언트가 필요한 메타데이터(인가 엔드포인트, 토큰 엔드포인트 등)를 탐색할 수 있도록 합니다.
• 인프라스트럭처: AWS CDK를 사용하여 Lambda 함수, API Gateway, Lambda Authorizer 등 필요한 AWS 리소스를 정의하고 배포합니다.
• 로컬 테스트: SAM CLI를 사용하여 로컬 환경에서 API를 실행하고 테스트합니다.
• 클라이언트 테스트: goose와 mcp-remote 패키지를 사용하여 MCP 서버와의 통신 및 동작을 검증합니다.

개발 임팩트

• 외부 ID 공급자를 활용한 통합적인 인증/인가 관리
• 서버리스 아키텍처를 통한 확장성 및 비용 효율성 증대
• Rust 언어를 활용한 고성능 및 안전한 서버 개발
• API Gateway와 Lambda Authorizer를 통한 책임 분리 및 보안 강화

커뮤니티 반응

• 원문에는 개발 과정에서의 어려움(MCP 사양 이해, 클라이언트 업데이트 지연)과 해결 과정이 솔직하게 공유되어 있으며, 실제 코드 예제와 함께 제공되어 실질적인 도움이 될 것으로 보입니다.