Model Context Protocol (MCP) 아키텍처 해부: JSON-RPC 2.0 기반 계층 설계·3대 프리미티브(Resources·Tools·Prompts)·Capability 협상과 에이전트 도구 표준화
Anthropic이 공개하고 현대 AI 에이전트 생태계의 표준으로 자리잡은 Model Context Protocol(MCP)의 2계층 구조(전송 계층: stdio·SSE / 데이터 계층: JSON-RPC 2.0)와 3대 프리미티브(Resources, Tools, Prompts), 1:1 클라이언트-서버 라이프사이클 및 보안 격리 모델을 분석하고 로컬 Python 6대 프로토콜 런타임 검증을 살펴본다.
Model Context Protocol (MCP) 코어 계층 아키텍처 및 분산 AI 에이전트 도구 상호운용성 추상 아트워크
인공지능 모델(LLM)이 단순한 텍스트 완성을 넘어 자율적인 추론과 도구 실행을 수행하는 에이전트 시대(Agentic Era)로 진입하면서, 소프트웨어 엔지니어링 환경은 전례 없는 파편화 문제에 직면했다. 지금까지 Claude Desktop, Cursor, VS Code, Zed, Antigravity 등 다양한 AI 호스트 애플리케이션은 각기 다른 독자적인 방식으로 외부 시스템(로컬 파일시스템, PostgreSQL, GitHub, Jira, Slack, 웹 브라우저 등)과 연동해야 했다. 호스트 애플리케이션이 개이고 연동 대상 도구 및 데이터 소스가 개라면, 생태계 전체가 무려 개의 커스텀 글루 코드(Glue Code)와 플러그인을 중복 개발·유지보수해야 하는 심각한 비효율이 발생했다.
Anthropic이 오픈 표준으로 공개한 Model Context Protocol (MCP)은 이러한 파편화 장벽을 무너뜨리고, AI 애플리케이션과 외부 컨텍스트·도구를 단일한 표준 규격으로 연결하는 개방형 프로토콜이다. 과거 마이크로소프트가 개발 도구 생태계의 언어 지원 파편화를 해결하기 위해 도입했던 **Language Server Protocol (LSP)**이 모든 IDE와 에디터를 통합했듯, MCP는 AI 에이전트와 외부 도구 생태계를 잇는 **"AI 에이전트 시대의 LSP"**로 빠르게 표준화되고 있다.
핵심 판단 기준을 먼저 요약하면, Model Context Protocol(MCP)은 전송 계층(Transport Layer: 로컬 Stdio 파이프라인 및 원격 SSE/HTTP)과 데이터 계층(Data Layer: 표준 JSON-RPC 2.0)을 엄격히 분리하고, AI 에이전트와 도구 간의 상호작용을 3대 코어 프리미티브인 Resources(애플리케이션 제어 읽기 전용 컨텍스트), Tools(모델 제어 실행 함수 및 부수 효과), Prompts(사용자 제어 대화형 워크플로우 템플릿)로 정형화한다. 호스트는 연결되는 개별 서버마다 1:1로 독립된 클라이언트 인스턴스를 격리 생성하여 세션 충돌과 장애 전파를 차단하며, 연결 시작 시 initialize와 양방향 Capability Negotiation(기능 협상)을 수행해 버전 호환성을 보장한다. 특히 로컬 stdio 서브프로세스 샌드박싱과 호스트 레벨의 보안 권한 게이트(Human-in-the-loop)를 프로토콜 설계 단계부터 내장하여, 파괴적인 시스템 변경이나 데이터 유출을 원천적으로 차단한다. 이 글은 공식 Model Context Protocol Specification과 레퍼런스 구현체를 교차 검증해 정리한 분석이며, 공식 프로토콜 명세와 로컬 Python 6대 시뮬레이션 검증을 기준으로 설명한다.
1. MCP의 2계층 프로토콜 설계: 전송 계층과 데이터 계층
Model Context Protocol의 가장 큰 아키텍처적 강점은 **'메시지를 어떻게 운반하는가(Transport Layer)'**와 **'메시지가 무엇을 의미하는가(Data Layer)'**를 철저히 분리한 점이다. 이를 통해 개발자는 동일한 비즈니스 로직(도구, 리소스)을 단 한 줄의 코드 수정 없이 로컬 CLI 프로세스로도, 원격 클라우드 마이크로서비스로도 손쉽게 배포할 수 있다.
1.1 전송 계층 (Transport Layer): Stdio vs SSE / HTTP
MCP는 실행 환경의 물리적 위치와 보안 격리 수준에 따라 2가지 공식 전송 방식을 지원한다:
- Stdio 전송 (Standard Input/Output):
- 로컬 프로세스 격리: 호스트 애플리케이션(예: Cursor, Claude Desktop)이 로컬 머신에서 Node.js나 Python으로 작성된 MCP 서버를 하위 자식 프로세스(Subprocess)로 직접 생성(Spawn)한다.
- 파이프라인 통신: 호스트의
stdin에 JSON-RPC 메시지를 한 줄씩 쓰고(Line-delimited JSON), 서버의stdout을 한 줄씩 읽는 파이프 통신을 수행한다. - 네트워크 공격 표면 제거: 로컬 루프백 포트(TCP 8080 등)를 열지 않으므로, 동일 머신 내 악성 웹페이지나 스크립트가 포트 스캐닝을 통해 무단 접근하는 로컬 브라우저 공격(DNS Rebinding, CSRF)을 원천 차단한다.
- SSE / Streamable HTTP 전송 (Server-Sent Events):
- 원격 엔터프라이즈 통합: 원격 클라우드(AWS, Cloudflare Workers, 사내 쿠버네티스 클러스터)에서 운영되는 멀티 테넌트 MCP 서버와의 연동에 사용된다.
- 단방향 스트림과 업스트림 POST의 결합: 서버에서 클라이언트로의 실시간 이벤트 푸시(알림, 상태 변경)는 HTTP SSE 엔드포인트(
GET /sse)를 통해 지속적으로 수신하고, 클라이언트의 요청 명령은 별도의 HTTP POST 엔드포인트(POST /message)로 전송한다. - 표준 인증 체계: 표준 HTTP 헤더를 그대로 활용하므로 OAuth2 Bearer 토큰, mTLS, API Key 등 기존 엔터프라이즈 보안 인프라를 그대로 적용할 수 있다.
1.2 데이터 계층 (Data Layer): JSON-RPC 2.0 프레이밍 규격
MCP의 모든 메시지 교환은 업계에서 수십 년간 검증된 경량 표준인 JSON-RPC 2.0 규격을 준수한다. 불필요하게 복잡한 커스텀 바이너리 프로토콜이나 무거운 gRPC 스키마 컴파일 없이, 순수 JSON 텍스트만으로 모든 요청과 응답을 직렬화한다:
- 요청 (Request): 클라이언트나 서버가 상대방에게 특정 프로시저의 실행을 요구하고 결과를 기다린다. 고유한 식별자
id가 반드시 포함된다:
- 응답 (Response): 요청에 대한 성공 결과 또는 에러 정보를 반환하며, 요청 시 전달받았던
id를 정확히 매핑한다:
- 알림 (Notification): 응답을 기대하지 않는 단방향 이벤트 브로드캐스트로,
id필드가 존재하지 않는다(예: 리소스 변경 알림, 초기화 완료 통보):
- 표준 에러 코드: JSON-RPC 2.0 표준 에러 코드(
-32700Parse error,-32600Invalid Request,-32601Method not found,-32602Invalid params)를 엄격하게 사용하여 클라이언트가 에러 유형을 명확하게 분기 처리할 수 있도록 보장한다.
2. 혼동하기 쉬운 4가지 기술 경계 및 런타임 동작 비교
MCP를 도입할 때 기존의 REST API 통합이나 OpenAI Function Calling 방식과 혼동하여 잘못된 아키텍처를 설계하는 경우가 빈번하다. 반드시 명확히 구분해야 할 4가지 기술적 경계는 다음과 같다:
- Host와 Server 사이의 1:1 전용 Client 결합 원칙:
- MCP Host(예: Claude Desktop)가 로컬 파일시스템 서버와 원격 PostgreSQL 서버 2개에 연결되어 있다면, 하나의 거대한 클라이언트가 여러 서버를 묶어서 관리하지 않는다.
- 호스트는 각 MCP 서버마다 정확히 1개의 독립된 MCP Client 인스턴스를 1:1로 스폰한다.
- 따라서 파일시스템 서버가 일시적으로 크래시되거나 연결이 끊어져도, 데이터베이스 클라이언트의 세션과 헬스체크에는 전혀 영향을 주지 않는 완전한 장애 격리(Fault Compartmentalization)가 달성된다.
- Resources와 Tools의 명확한 제어 주체 차이:
- Resources: 애플리케이션(Host/Application) 주도의 읽기 전용 데이터다. LLM이 능동적으로 판단해 호출하는 것이 아니라, 사용자가 문서를 첨부하거나 호스트가 상황에 맞춰 LLM의 프롬프트 컨텍스트에 '주입(Feed)'하는 정적·동적 데이터다.
- Tools: 모델(LLM) 주도의 실행형 함수다. 사용자의 질문을 분석한 LLM이 스스로 판단하여 필요한 인자를 구성해 호출을 요청하며, 데이터베이스 쓰기나 API 호출 등 환경에 부수 효과(Side-effect)를 유발할 수 있다.
- 무상태(Stateless) 서버 설계와 세션의 경계:
- MCP 서버는 원칙적으로 상태를 내부에 장기 보존하지 않는 무상태(Stateless) 구조를 지향한다. 모든 필요한 컨텍스트는 요청의
params에 명시적으로 전달되어야 한다. - 단, Stdio 전송의 경우 프로세스가 살아있는 동안 서브프로세스 메모리를 유지할 수 있으며, SSE 원격 전송의 경우
Mcp-Session-Id와 같은 세션 헤더를 통해 논리적 세션을 식별한다.
- 보안 샌드박싱과 Human-in-the-loop 권한 게이트:
- 전통적인 Function Calling은 모델이 도구 호출 JSON을 생성하면 백엔드 코드가 즉시 이를 실행(Blind Execution)해 버려 보안 사고의 위험이 컸다.
- MCP 아키텍처에서는 **호스트 애플리케이션 내부에 보안 권한 게이트(Permission Gate)**가 필수적으로 배치된다. 읽기 전용 도구는 자동 승인할 수 있지만, 파일 삭제(
rm)나 DB 드롭(DROP TABLE)과 같은 파괴적 도구는 반드시 사용자에게 확인 팝업을 띄워 명시적 동의를 얻은 후에만 실행된다.
| 비교 항목 | 전통적 REST API / Webhook 연동 | 단일 LLM Function Calling (OpenAI 등) | Model Context Protocol (MCP) |
| 생태계 결합도 | 개별 SDK 및 맞춤형 글루 코드 | 특정 LLM 벤더 API 포맷에 종속됨 | 개방형 표준 (호스트 개 ↔ 서버 개 표준 연결) |
| 프로토콜 계층 | 일반 HTTP/REST (비표준 엔드포인트) | 채팅 완료(Chat Completion) 페이로드 내 인라인 | JSON-RPC 2.0 기반 정형 프로토콜 (Stdio / SSE) |
| 핵심 프리미티브 | 단순 API 엔드포인트 (CRUD) | 단일 Tools (함수 정의)만 지원 | Resources (데이터) + Tools (액션) + Prompts (템플릿) |
| 동적 기능 협상 | 문서 기반 수동 확인 | 매 요청마다 전체 스키마를 프롬프트에 재전송 | initialize 핸드셰이크 시점에 Capability 상호 협상 |
| 보안 및 격리 | 원격 서버 권한에 전적으로 의존 | 호스트 애플리케이션의 자체 구현에 의존 | Stdio 서브프로세스 샌드박스 + 권한 게이트 기본 내장 |
3. MCP 3대 코어 프리미티브 및 프로토콜 수명주기 심층 분석
Model Context Protocol (MCP) 코어 아키텍처 (Host 애플리케이션, 1:1 격리 Client, Stdio/SSE 전송 계층, Resources/Tools/Prompts 3대 프리미티브 및 수명주기 시퀀스) 상세 다이어그램
MCP의 아키텍처는 클라이언트와 서버가 서로를 탐색하고 안전하게 통신할 수 있도록 정교한 계층과 규격을 정의한다.
3.1 The 3 Server Primitives: Resources, Tools, Prompts
MCP 서버가 호스트와 모델에게 노출할 수 있는 기능은 정확히 3가지 범주로 정규화된다:
- Resources (애플리케이션 제어 읽기 전용 데이터):
- 표준 URI 체계(
file:///,postgres://,git://,notion://)를 통해 접근 가능한 모든 정적·동적 데이터다. resources/list메서드로 사용 가능한 리소스 목록(이름, URI, MIME 타입)을 조회하고,resources/read로 실제 바이너리(Blob)나 텍스트 내용을 가져온다.- 리소스 내용이 변경되면 서버는 호스트에
notifications/resources/updated알림을 전송하여 실시간 동기화를 지원한다.
- Tools (모델 제어 실행 액션):
- LLM이 직접 호출하여 시스템 상태를 변경하거나 외부 연산을 수행하는 실행 가능한 함수다.
tools/list를 통해 도구의 이름, 설명, 그리고 JSON Schema 기반의 엄격한 입력 매개변수 명세를 호스트에 전달한다.- LLM이 인자를 결정하면 호스트는
tools/call을 호출해 서버에서 로직을 실행하고 표준화된content배열(텍스트, 이미지, 임베디드 리소스)로 결과를 반환받는다.
- Prompts (사용자 제어 상호작용 템플릿):
- 복잡한 프롬프트 엔지니어링이나 모범 사례를 서버가 사전 패키징하여 제공하는 템플릿이다.
- 예를 들어 코드 리뷰 서버는
review-pr이라는 프롬프트를 정의하고diff,language등의 인자를 요구할 수 있다. - 사용자가 호스트 UI(예: 슬래시 커맨드
/)에서 프롬프트를 선택하면prompts/get이 호출되어 정형화된 시스템 및 유저 메시지 배열이 LLM 컨텍스트에 즉시 로드된다.
3.2 4단계 프로토콜 라이프사이클 시퀀스
클라이언트와 서버가 연결될 때, 임의로 도구를 먼저 호출하는 것은 엄격히 금지된다. 반드시 다음 4단계 수명주기 핸드셰이크를 거쳐야 한다:
- 1단계:
initialize요청 (Client → Server): - 클라이언트는 자신이 지원하는 최신 프로토콜 버전(예:
2024-11-05)과 클라이언트 기능(루트 목록 변경 감지roots, 모델 샘플링sampling등)을 담아 요청을 보낸다.
- 2단계:
initialize응답 (Server → Client): - 서버는 상호 지원 가능한 프로토콜 버전을 확정하고, 자신의 메타데이터(서버 이름, 버전)와 지원하는 3대 프리미티브 기능 플래그(예:
tools.listChanged: true,resources.subscribe: true)를 반환한다. - 이 시점에서 양측은 서로의 기능 지원 범위를 정확히 인지하게 된다.
- 3단계:
notifications/initialized알림 (Client → Server): - 협상이 성공적으로 끝나면 클라이언트는 서버에 초기화가 완료되었음을 알리는 단방향 알림을 보낸다.
- 이 알림을 수신한 서버는 비로소 내부 상태를
INITIALIZED로 전환하고 일반 RPC 트래픽을 처리할 준비를 마친다.
- 4단계: 런타임 RPC 트래픽 교환 (Normal Operation):
- 이후 클라이언트는
tools/list,tools/call,resources/read,prompts/get등의 비즈니스 RPC를 자유롭게 송수신하며, 주기적인ping요청을 통해 연결 생존 여부를 모니터링한다.
4. 실무 설정·코드 예제와 로컬 Python 6대 검증 스크립트
4.1 실제 FastMCP / Python MCP 서버 구현 패턴
최신 Python 생태계에서는 mcp 공식 SDK나 FastMCP 라이브러리를 사용하여 데코레이터 기반으로 초경량 MCP 서버를 작성할 수 있다:
4.2 로컬 Python 6대 런타임 프로토콜 불변식 검증 스크립트
아래 Python 스크립트는 Model Context Protocol의 6대 핵심 아키텍처 규칙(JSON-RPC 2.0 프레이밍 및 에러 규격, initialize 핸드셰이크 및 Capability Negotiation, 3대 프리미티브 디스패치 무결성, Host-Client 1:1 엄격한 격리, Stdio 라인 스트림 전송 시뮬레이션, End-to-End AI 에이전트 도구 호출 루프 및 보안 권한 게이트)을 로컬 환경에서 단 하나의 외부 의존성 없이 철저하게 검증한다:
실행 결과:
5. 실무 도입 및 프로덕션 마이그레이션 체크리스트
Stdio vs SSE 전송 계층의 명확한 분리: 로컬 개발 도구 및 데스크톱 앱 연동에는 네트워크 포트 오픈이 불필요한 stdio 서브프로세스를 사용하고, 중앙 집중식 사내 인프라 및 멀티 테넌트 서비스에는 인증 토큰이 적용된 SSE/Streamable HTTP를 구성한다.
3대 프리미티브(Resources/Tools/Prompts)의 명확한 책임 할당: 단순 파일 내용이나 DB 스키마 같은 참조 데이터는 resources로 정의하고, 모델이 직접 실행해야 하는 함수는 엄격한 JSON Schema를 갖춘 tools로 선언하며, 반복적인 대화 매크로는 prompts로 분리한다.
호스트 보안 권한 게이트(Permission Gate) 수립: 쓰기(write), 삭제(delete), 외부 전송(send) 등 파괴적 부수 효과를 일으키는 도구는 사용자 확인 팝업이나 환경별 화이트리스트 승인 절차를 반드시 거치도록 호스트 측 오케스트레이터를 구성한다.
JSON-RPC 2.0 표준 에러 코드 준수: 파라미터 누락 시 -32602(Invalid params), 미지원 도구 요청 시 -32601(Method not found) 등 규격화된 에러 코드를 반환하여 모델이 반환된 에러를 바탕으로 올바른 자가 수정(Self-Correction)을 유도한다.
1:1 클라이언트 세션 독립성 유지: 하나의 복합 호스트 애플리케이션 내에서 여러 개의 MCP 서버를 연결할 때, 클라이언트 객체를 공유하지 않고 각 서버마다 전용 클라이언트를 1:1로 할당하여 장애가 연쇄 전파되지 않도록 설계한다.
버전 협상 및 프로토콜 호환성 검증: initialize 핸드셰이크 과정에서 protocolVersion을 엄격히 확인하고 지원하지 않는 버전이 인입될 경우 적절한 하위 호환 폴백 또는 명확한 지원 불가 에러를 응답한다.
6. 참고 자료 및 공식 출처 (2026-11-17 확인)
확인 기준일: November 17, 2026