rekog-labs/MCP-Nest

해결하는 문제

NestJS 프레임워크 내에서 Model Context Protocol (MCP) 서버를 구축하는 과정을 단순화합니다. 서버를 처음부터 구축하는 대신, 익숙한 NestJS 패턴을 사용하여 AI 에이전트에 도구, 리소스, 프롬프트를 노출할 수 있습니다. 이를 통해 기존 기업용 코드베이스 로직을 AI 워크플로우에 통합할 수 있습니다.

작동 방식

이 라이브러리는 MCP를 NestJS 마이크로서비스 전송 전략으로 구현합니다. @McpController() 데코레이터를 사용하면 @Tool (Zod 검증 포함)를 사용해 도구, 리소스, 프롬프트를 정의할 수 있습니다. 이러한 항목들은 Streamable HTTP 및 STDIO와 같은 여러 전송 옵션을 통해 제공됩니다. NestJS의 의존성 주입 시스템을 활용하므로, 가드, 파이프, 인터셉터, 예외 필터가 MCP 핸들러와 자연스럽게 작동합니다.

대상 사용자

NestJS를 사용하여 AI 에이전트가 애플리케이션의 데이터와 기능에 접근할 수 있도록 하는 MCP 서버를 만들고 싶은 백엔드 개발자들입니다.

주요 특징

• NestJS 통합: CustomTransportStrategy를 사용하여 표준 NestJS 미들웨어(가드, 파이프, 인터셉터)가 AI 도구에 적용됩니다.
• 이중 시대 프로토콜 지원: 하나의 엔드포인트가 2025년형과 2026-07-28 상태 없는 프로토콜 리비전을 동시에 제공할 수 있습니다.
• 다중 전송 지원: Streamable HTTP와 STDIO 전송을 모두 지원합니다.
• 기업용 준비 완료: 도구별 세밀한 권한 부여 및 내장 및 외부 인증 서버(예: Keycloak, Auth0)와의 통합을 지원합니다.
• Zod 검증: Zod를 사용한 도구 매개변수의 자동 탐지 및 검증이 가능합니다.