workshop-27-08-26

2026년 8월 27일 부트캠프 AWS AI FDE for Commerce 워크숍을 위한 MCP 서버 예시

MCP란 무엇인가?

MCP (Model Context Protocol)는 시스템 간 통신을 위한 오픈소스 프로토콜로, 서로 다른 애플리케이션(주로 AI) 간에 데이터/컨텍스트 정보를 교환할 수 있게 해줍니다.

이 프로토콜을 사용하면 AI 시스템(예: 에이전트 애플리케이션)이 다른 시스템의 컨텍스트 정보를 소비/제공할 수 있어, 모델이 더 확실하고 관련성 있게 작동할 수 있습니다.

USB-C 비유를 사용하면:

MCP를 AI 애플리케이션을 위한 USB-C 포트라고 생각하세요. USB-C가 전자 기기를 연결하는 표준화된 방법을 제공하듯이, MCP는 AI 애플리케이션을 다른 시스템에 연결하는 표준 방법을 제공합니다.

Related MCP server: Basic MCP Server

SDK 옵션

이 프로토콜은 다양한 SDK(Software Development Kit) 옵션을 지원하며, 이를 통해 여러 언어/프레임워크에서 MCP를 구현할 수 있습니다.

전체 목록은 여기에서 확인하세요: 사용 가능한 SDK

전송 옵션

워크숍 맥락에 초점을 맞춰, Node.js에서 가장 일반적/인기 있는 전송 옵션을 살펴보겠습니다:

stdio

MCP 서버를 자식 프로세스로 실행하고, stdin과 stdout을 통해 메시지를 주고받습니다.

stdio로 서비스하기

HTTP

여러 클라이언트에 동시에 HTTP 요청을 통해 메시지를 주고받는 서버를 제공합니다.

HTTP로 서비스하기

프레임워크

MCP 프로토콜 구현을 용이하게 하기 위해 Node.js 기술/프레임워크를 사용합니다. 예:

• Express

• Fastify

• Hono

워크숍 시나리오

고객 Nordesul

1. 대규모 고객의 e-커머스 프로젝트를 고려해 보세요. 20명의 개발자 팀이 레거시 가상 스토어(V0)를 더 현대적인 프레임워크(V1)로 마이그레이션하는 작업을 맡고 있습니다. 목표는 V1 가상 스토어가 V0와 동일하지만 V1의 성능 개선을 사용하는 것입니다.

2. 여러 개발자가 동일한 코드베이스에서 작업하므로, 배포물이 우리 회사의 표준과 정체성을 따르며 최상의 표준화와 품질을 갖추는 것이 필수적입니다.

3. 고객은 모든 API 문서를 포함한 데이터베이스를 보유하고 있으며, 이는 개발 팀과 공유된 엔드포인트에 있어 조회할 수 있습니다.

이 저장소

이 저장소는 다음과 같은 용도로 사용할 수 있는 MCP 서버 템플릿을 포함합니다:

• @modelcontextprotocol/server를 사용한 stdio 및 HTTP 전송 구현 이해;

• AI 시스템과 외부 서비스 간의 통신 시뮬레이션;

• 실제 MCP 서버 구현을 위한 영감 제공;

• 맞춤형 tools를 사용한 AI 에이전트 사용의 진입점 역할.

저장소 구조

/servers

다양한 전송 방식과 프레임워크를 사용하는 예제 MCP 서버.

• /servers/stdio

자식 프로세스로 stdin과 stdout을 통해 MCP 메시지를 제공합니다.

• /servers/http

Node.js의 기본 HTTP 모듈만 사용하여 HTTP 요청을 통해 MCP 메시지를 제공합니다.

• /servers/express

Express 프레임워크를 사용하여 HTTP 요청을 통해 MCP 메시지를 제공합니다.

/tools

AI 에이전트가 다른 시스템과 상호작용하는 데 사용할 수 있는 맞춤형 tools 예시.

• /tools/index.js

저장소의 모든 tools를 중앙 집중화하고 내보내어, MCP 서버가 통합된 방식으로 등록할 수 있게 합니다.

• /tools/nordesul-deploy

Nordesul 고객에게 안전한 배포를 위한 필수 주의사항과 모범 사례를 반환합니다.

• /tools/nordesul-delivery

프로젝트의 구현 패턴과 계약을 시뮬레이션합니다.

• /tools/nordesul-reference

Nordesul 고객의 API 문서 조회를 시뮬레이션합니다.

• /tools/nordesul-status

Nordesul 고객의 애플리케이션 상태 조회를 시뮬레이션합니다.

/utils

프로젝트의 유틸리티/공유 함수를 중앙 집중화합니다.

/.opencode

Opencode 설정 디렉토리로, 워크숍 참가자가 저장소와 기능을 이해하도록 돕는 맞춤형 mentor 에이전트를 포함합니다.

프로젝트 실행

사전 요구 사항

• Git;

• 워크숍 저장소 클론;

• Opencode (또는 MCP를 지원하는 다른 AI 에이전트) 설치 및 구성;

• Node.js (>= LTS 권장)

• 패키지 매니저 (npm 또는 yarn)

의존성 설치

프로젝트 루트에서 다음 명령을 실행하세요:

npm install

# ou:

yarn install

서버 실행

stdio를 통한 MCP 서버:

npm run start:stdio

# ou:

yarn start:stdio

http를 통한 MCP 서버:

npm run start:http

# ou:

yarn start:http

Express 통합을 통한 MCP 서버:

npm run start:express

# ou:

yarn start:express

멘토 에이전트 실행 (Opencode 예시)

Opencode가 설치된 상태에서 저장소 디렉토리에서 원하는 터미널을 열고 다음 명령을 실행하세요:

opencode

첫 실행 시 Opencode의 모든 의존성이 다운로드되므로 프로세스가 완료될 때까지 기다리세요. Mentor 에이전트가 기본적으로 선택되어 있을 것입니다.

MCP 서버와 AI 에이전트 통합

• Opencode: MCP 서버;

• Claude: MCP를 통한 Claude Code 도구 연결;

• Codex: Model Context Protocol;

• Cursor: Model Context Protocol (MCP);

• Antigravity: Model Context Protocol (MCP).

예시 프롬프트

에이전트를 사용하여 저장소의 tools와 상호작용하는 몇 가지 예시:

nordesul-delivery

Quais são os padrões de implementação para a área de checkout do Nordesul?

nordesul-deploy

Antes de eu publicar essa mudança no Nordesul, quais cuidados devo tomar?

nordesul-reference

Me mostra a documentação da API de pedidos (orders) do Nordesul.

nordesul-status

Qual o status atual da aplicação checkout-service no Nordesul?