MCP 아키텍처 완전 해설 — 호스트·클라이언트·서버 3계층 구조 도식화
MCP 아키텍처의 호스트·클라이언트·서버 3계층 구조를 도식과 함께 완전히 이해하세요. MCP 동작 원리와 데이터 흐름을 단계별로 정리했습니다.
MCP(Model Context Protocol)는 AI 호스트 애플리케이션과 외부 도구·데이터 소스를 표준화된 방식으로 연결하는 오픈 프로토콜입니다. 핵심은 세 계층 — 호스트(Host), 클라이언트(Client), 서버(Server) — 의 역할 분리입니다. 이 구조를 이해하면 MCP 서버를 왜 이렇게 만드는지, 왜 어떤 AI 앱에서도 같은 서버를 재사용할 수 있는지가 자연스럽게 납득됩니다.
MCP가 등장한 이유
LLM(대규모 언어 모델)은 텍스트를 잘 다루지만 최신 데이터 조회, 파일 수정, API 호출 같은 실제 작업은 혼자 할 수 없습니다. 기존에는 각 AI 앱이 자체 플러그인·함수 호출 체계를 만들어 도구를 연결했고, 그 결과 같은 기능을 Cursor용·Claude Desktop용·Copilot용으로 각각 따로 구현해야 했습니다.
MCP는 이 문제를 “도구 서버를 독립 프로세스로 분리하고, 호스트-서버 간 통신을 표준화” 해서 해결합니다. 서버 하나를 잘 만들면 MCP를 지원하는 모든 AI 앱에서 즉시 재사용할 수 있습니다.
3계층 구조 한눈에 보기
MCP 아키텍처는 아래 세 계층으로 이루어집니다.
┌──────────────────────────────────────────────┐
│ 호스트(Host) │
│ 예: Claude Desktop, Cursor, VS Code 확장 │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ 클라이언트 │ │ 클라이언트 │ (여러 개) │
│ │ (Client A) │ │ (Client B) │ │
│ └──────┬──────┘ └──────┬──────┘ │
└─────────┼────────────────┼──────────────────┘
│ MCP 프로토콜 │ MCP 프로토콜
▼ ▼
┌────────────┐ ┌────────────┐
│ MCP 서버 │ │ MCP 서버 │
│ (Server A)│ │ (Server B)│
└────────────┘ └────────────┘
│ │
▼ ▼
외부 API / 파일시스템 / DB / 한국 공공 API 등
호스트(Host)
호스트는 사용자가 직접 대화하는 AI 애플리케이션입니다. Claude Desktop, Cursor, VS Code의 MCP 확장 등이 해당됩니다. 호스트는 다음 두 가지를 담당합니다.
- LLM 추론 실행: 사용자 메시지를 받아 모델에 전달, 응답을 다시 사용자에게 보여줌
- 클라이언트 라이프사이클 관리: 연결할 MCP 서버 목록을 설정에서 읽고, 각 서버마다 클라이언트 인스턴스를 생성·유지·종료
클라이언트(Client)
클라이언트는 호스트 안에 내장된 통신 모듈로, MCP 서버와 1:1 세션을 유지합니다. 사용자에게 직접 보이지 않지만 MCP의 핵심 동작이 여기서 일어납니다.
| 역할 | 설명 |
|---|---|
| 능력 협상 | 서버가 지원하는 기능(Tools/Resources/Prompts) 목록을 초기화 단계에서 요청 |
| 요청 중계 | 모델이 도구 호출을 결정하면 해당 서버로 요청 전달 |
| 결과 반환 | 서버가 반환한 결과를 모델 컨텍스트에 삽입 |
| 구독 관리 | 리소스 변경 알림(서버 → 클라이언트 방향)을 수신 |
하나의 호스트가 여러 클라이언트를 동시에 운용할 수 있어, 서버 A에서 파일을 읽으면서 서버 B로 API를 호출하는 것이 동시에 가능합니다.
서버(Server)
서버는 실제 기능을 구현하는 독립 프로세스입니다. MCP 규격에 따라 세 종류의 기능(Primitive)을 노출합니다.
| Primitive | 설명 | 예시 |
|---|---|---|
| Tools | AI가 실행하는 함수 (모델이 호출 결정) | 파일 읽기, API 조회, DB 쿼리 |
| Resources | 호스트가 구독하는 데이터 소스 | 프로젝트 파일, 로그 스트림 |
| Prompts | 재사용 가능한 프롬프트 템플릿 | 코드 리뷰 템플릿, 번역 지시문 |
서버는 반드시 원격에 있을 필요가 없습니다. 전송 방식에 따라 두 가지로 나뉩니다.
| 전송 방식 | 특징 | 적합한 상황 |
|---|---|---|
| stdio | 로컬 서브프로세스로 실행, 표준 입출력으로 통신 | 개인 개발, 로컬 도구 |
| HTTP + SSE | 원격 HTTP 서버, SSE로 서버→클라이언트 이벤트 전송 | 팀 공유, 클라우드 배포 |
MCP 동작 흐름 단계별 해설
실제로 사용자가 Claude Desktop에서 “이 HWP 파일의 내용을 요약해줘”라고 입력했을 때 어떤 일이 벌어지는지 단계별로 살펴보겠습니다.
1단계 — 초기화(Initialize)
호스트가 시작할 때 설정 파일(claude_desktop_config.json)을 읽어 등록된 MCP 서버 목록을 확인합니다. 각 서버에 대해 클라이언트 인스턴스를 생성하고 initialize 요청을 보냅니다. 서버는 자신이 지원하는 프로토콜 버전과 기능 목록(capabilities)을 응답합니다.
호스트 → 클라이언트 → 서버
initialize 요청
서버 → 클라이언트 → 호스트
capabilities 응답
(tools: ["read_hwp", "list_files"], resources: [...])
2단계 — 사용자 요청 수신
사용자가 메시지를 입력하면 호스트는 현재 연결된 서버들의 도구 목록을 시스템 프롬프트에 삽입한 뒤 LLM에 전달합니다. LLM은 이 목록을 보고 어떤 도구를 호출할지 결정합니다.
3단계 — 도구 호출(Tool Call)
LLM이 특정 도구 사용을 결정하면 모델 응답에 도구 호출 정보가 포함됩니다. 클라이언트가 이를 감지해 해당 MCP 서버로 tools/call 요청을 보냅니다.
호스트(LLM 응답) → 클라이언트 → MCP 서버
tools/call
{name: "read_hwp", arguments: {path: "/docs/보고서.hwp"}}
4단계 — 서버 실행 및 결과 반환
서버가 요청을 받아 실제 작업(HWP 파일 파싱, API 호출 등)을 수행하고 결과를 클라이언트에 반환합니다. 클라이언트는 이 결과를 LLM 컨텍스트에 추가합니다.
MCP 서버 → 클라이언트 → 호스트(LLM 컨텍스트)
{content: [{type: "text", text: "보고서 내용..."}]}
5단계 — 최종 응답 생성
LLM이 도구 실행 결과를 포함한 전체 컨텍스트를 바탕으로 최종 응답을 생성합니다. 필요하면 3~5단계를 반복해 여러 도구를 순차적으로 사용할 수도 있습니다.
호스트·클라이언트·서버 역할 비교표
| 계층 | 예시 구현체 | 사용자 가시성 | 주요 책임 |
|---|---|---|---|
| 호스트 | Claude Desktop, Cursor | 직접 보임 | LLM 추론, 설정 관리, UI |
| 클라이언트 | 호스트 내부 모듈 | 보이지 않음 | 서버 연결, 메시지 직렬화, 세션 유지 |
| 서버 | hwp-mcp, kordoc 등 | 보이지 않음 | 도구 구현, 실제 I/O 작업 |
실제로 쓸 수 있는 한국어 MCP 서버 예시
MCP 아키텍처를 이해했다면 실제 서버를 연결해 보는 것이 가장 빠른 학습법입니다. 한국 환경에서 바로 활용할 수 있는 서버 세 가지를 소개합니다.
코르독(KorDoc) — 한국 공문서 변환
코르독(KorDoc)은 HWP·HWPX·PDF·XLSX·DOCX 등 한국 공문서를 Markdown으로 변환하는 MCP 서버입니다. API 키 없이 아래 명령으로 설치합니다.
npx -y kordoc setup
HWP-MCP — 한글 문서 읽기·편집
HWP-MCP는 AI 어시스턴트가 한글(.hwp/.hwpx) 파일을 직접 읽고 편집·생성할 수 있게 해주는 서버입니다.
npx -y hwp-mcp
한포지(HwpForge) — HWPX 문서 읽기·쓰기·변환
한포지(HwpForge)는 한컴 한글 HWPX(KS X 6101) 형식을 AI 에이전트가 읽고 쓰고 변환할 수 있게 해주는 서버입니다.
npx -y @hwpforge/mcp
이 서버들은 모두 Claude Desktop 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 아래 형식으로 등록할 수 있습니다.
{
"mcpServers": {
"hwp-mcp": {
"command": "npx",
"args": ["-y", "hwp-mcp"]
}
}
}
흔한 오해와 오류
”MCP 서버가 직접 LLM에 접근하나요?”
그렇지 않습니다. 서버는 클라이언트의 요청에만 응답하며, LLM과 직접 통신하지 않습니다. 모든 LLM 호출은 호스트가 독점합니다.
초기화 실패 — “Server disconnected” 오류
가장 흔한 원인은 Node.js 버전 불일치나 npx 캐시 문제입니다. 다음 순서로 확인하세요.
node -v로 Node.js 18 이상인지 확인npx --version으로 npx 정상 동작 확인- Claude Desktop 로그(
~/Library/Logs/Claude/mcp*.log)에서 구체적인 에러 메시지 확인 - 서버
command/args경로를 절대 경로로 변경해 시도
”Tools not found” — 도구 목록이 비어 있음
서버가 초기화 단계에서 capabilities를 정상 반환하지 못한 경우입니다. 해당 서버의 GitHub 저장소에서 최신 버전 여부와 known issues를 확인하세요.
자주 묻는 질문
MCP 호스트와 MCP 클라이언트는 어떻게 다른가요?
호스트(Host)는 Claude Desktop·Cursor처럼 사용자가 직접 대화하는 AI 애플리케이션 자체입니다. 클라이언트(Client)는 호스트 내부에 내장되어 MCP 서버와 실제로 통신하는 모듈로, 하나의 호스트가 여러 클라이언트 인스턴스를 동시에 유지할 수 있습니다.
MCP 서버는 반드시 원격(Remote)으로 배포해야 하나요?
아닙니다. MCP 서버는 로컬 프로세스(stdio 전송)로도, HTTP+SSE 방식의 원격 서버로도 운용할 수 있습니다. 개발 초기에는 로컬 stdio가 간편하고, 프로덕션 팀 공유 환경에서는 원격 HTTP 서버가 유리합니다.
하나의 호스트에 MCP 서버를 몇 개까지 연결할 수 있나요?
프로토콜 상 제한은 없습니다. Claude Desktop 기준으로 설정 파일에 원하는 만큼 서버를 등록할 수 있으며, 각 서버에 대해 독립적인 클라이언트 세션이 생성됩니다. 다만 서버 수가 많을수록 초기화 시간과 컨텍스트 길이에 영향을 줄 수 있습니다.
MCP와 기존 함수 호출(Function Calling)의 차이는 무엇인가요?
함수 호출은 모델과 도구가 단일 API 호출 안에서 결합되어 있어 확장이 어렵습니다. MCP는 도구 정의·실행·결과 반환을 별도의 표준 서버로 분리했기 때문에, 언어나 런타임에 관계없이 어떤 AI 호스트에서도 동일한 서버를 재사용할 수 있습니다.
MCP 서버에서 제공할 수 있는 기능 종류는 무엇인가요?
MCP 서버는 Tools(AI가 실행하는 함수), Resources(파일·DB 데이터 노출), Prompts(재사용 가능한 프롬프트 템플릿) 세 가지 원시 기능(primitive)을 제공할 수 있습니다. 서버마다 이 중 일부 또는 전부를 구현합니다.
MCP를 처음 배우려면 어디서 시작해야 하나요?
개념 이해 후 실제 서버를 연결해 보는 것이 가장 빠릅니다. MCP모아의 서버 목록에서 관심 있는 서버를 선택해 Claude Desktop에 연결해 보세요. 한국어 문서·공문서를 다루는 서버부터 시작하면 국내 환경에서 즉시 체감할 수 있습니다.
다음 단계
MCP 아키텍처의 3계층 구조를 이해했다면, 이제 실제 서버를 연결해 직접 경험해 보세요.
- 개발 도구 카테고리 전체 서버 보기 — MCP를 지원하는 다양한 개발 도구 서버 탐색
- MCP 서버 전체 목록 — 한국에서 활용할 수 있는 MCP 서버 디렉토리
- 가이드 전체 목록 — MCP 설치·설정·활용 가이드 모음
- 직접 만든 MCP 서버가 있다면 서버 등록 신청으로 MCP모아에 소개하세요