Model Context Protocol 문서: MCP 서버의 구조와 동작 방식 이해하기
리퀘오 운영팀
이 글은 Model Context Protocol 문서의 'MCP 서버 이해하기'를 한국어로 옮긴 것이다. MCP 서버가 어떤 구성 요소로 기능을 노출하는지, 그리고 여러 서버가 함께 동작할 때 어떤 일이 가능한지 알고 싶은 개발자와 AI 도구 사용자에게 도움이 된다.
1. MCP 서버란 무엇인가
MCP 서버는 표준화된 프로토콜 인터페이스를 통해 AI 애플리케이션에 특정 기능을 제공하는 프로그램이다. 흔한 예로 문서 접근용 파일 시스템 서버, 데이터 조회용 데이터베이스 서버, 코드 관리용 GitHub 서버, 팀 커뮤니케이션용 Slack 서버, 일정 관리를 위한 캘린더 서버 등이 있다.
2. 서버의 세 가지 구성 요소
서버는 세 가지 블록으로 기능을 제공한다.
- 도구(Tools): 모델이 능동적으로 호출하는 함수다. 사용자 요청에 따라 모델이 사용 시점을 결정한다. 데이터베이스에 쓰거나, 외부 API를 호출하거나, 파일을 수정하거나, 다른 로직을 실행할 수 있다. 예로 항공편 검색, 메시지 전송, 일정 생성이 있다. 제어 주체는 모델이다.
- 리소스(Resources): 읽기 전용 정보를 문맥으로 제공하는 수동적 데이터 원천이다. 파일 내용, 데이터베이스 스키마, API 문서 등이 해당한다. 예로 문서 조회, 지식 베이스 접근, 캘린더 읽기가 있다. 제어 주체는 애플리케이션이다.
- 프롬프트(Prompts): 모델이 특정 도구와 리소스를 어떻게 활용할지 알려주는 미리 만들어진 지시 템플릿이다. 예로 휴가 계획, 회의 요약, 이메일 초안 작성이 있다. 제어 주체는 사용자다.
이하에서는 가상의 여행 계획 시나리오로 각 요소의 역할과 상호작용을 살펴본다.
3. 도구
도구는 AI 모델이 행동을 수행하게 한다. 각 도구는 형식이 지정된 입력과 출력을 가진 단일 작업을 정의하며, 모델은 문맥에 따라 실행을 요청한다.
도구는 스키마로 정의된 인터페이스이고, MCP는 검증에 JSON Schema를 사용한다. 도구 실행 전 사용자 동의를 요구할 수 있어 사용자가 모델의 행동을 통제할 수 있다.
프로토콜 연산은 두 가지다.
- tools/list: 사용 가능한 도구를 탐색하며, 스키마를 포함한 도구 정의 배열을 반환한다.
- tools/call: 특정 도구를 실행하며, 실행 결과를 반환한다.
도구 정의 예시는 다음과 같다.
```typescript
{
name: "searchFlights",
description: "Search for available flights",
inputSchema: {
type: "object",
properties: {
origin: { type: "string", description: "Departure city" },
destination: { type: "string", description: "Arrival city" },
date: { type: "string", format: "date", description: "Travel date" }
},
required: ["origin", "destination", "date"]
}
}
```
여행 예약 예시에서 AI 애플리케이션은 여러 도구로 휴가 예약을 돕는다.
- 항공편 검색: searchFlights(origin: "NYC", destination: "Barcelona", date: "2024-06-15")는 여러 항공사를 조회해 구조화된 항공편 옵션을 반환한다.
- 캘린더에 일정 잡기: createCalendarEvent(title: "Barcelona Trip", startDate: "2024-06-15", endDate: "2024-06-22")는 사용자 캘린더에 여행 기간을 표시한다.
- 이메일 알림: sendEmail(to: "team@work.com", subject: "Out of Office", body: "...")는 동료에게 자동 부재중 메시지를 보낸다.
도구는 모델이 제어하므로 AI가 자동으로 탐색하고 호출할 수 있다. 다만 MCP는 여러 장치로 사람의 감독을 강조한다. 신뢰와 안전을 위해 애플리케이션은 UI에 사용 가능한 도구를 표시해 특정 상호작용에서 도구를 쓸지 사용자가 정하게 하거나, 개별 실행에 대한 승인 대화상자, 안전한 작업의 사전 승인 권한 설정, 모든 실행과 결과를 보여주는 활동 로그 등을 구현할 수 있다.
4. 리소스
리소스는 AI 애플리케이션이 검색해 모델에 문맥으로 제공할 수 있는 구조화된 정보 접근을 제공한다.
리소스는 파일, API, 데이터베이스 등 AI가 문맥 파악에 필요한 데이터를 노출한다. 애플리케이션은 이 정보에 직접 접근해 관련 부분 선택, 임베딩 검색, 전체 전달 등 활용 방식을 스스로 정한다. 각 리소스는 고유 URI(예: file:///path/to/document.md)를 가지며 적절한 처리를 위해 MIME 타입을 선언한다.
탐색 방식은 두 가지다.
- 직접 리소스: 특정 데이터를 가리키는 고정 URI다. 예: calendar://events/2024는 2024년 캘린더 가용성을 반환한다.
- 리소스 템플릿: 매개변수가 있는 동적 URI로 유연한 질의를 지원한다. 예: travel://activities/{city}/{category}는 도시와 분류별 활동을 반환하고, travel://activities/barcelona/museums는 바르셀로나의 모든 박물관을 반환한다.
리소스 템플릿은 제목, 설명, 예상 MIME 타입 같은 메타데이터를 포함해 탐색 가능하고 스스로 문서화된다.
프로토콜 연산은 네 가지다.
- resources/list: 사용 가능한 직접 리소스 목록을 반환한다.
- resources/templates/list: 리소스 템플릿을 탐색한다.
- resources/read: 리소스 내용을 읽어 온다.
- subscriptions/listen: 리소스 변경을 모니터링한다.
특정 리소스의 변경을 지켜보려면 클라이언트가 resourceSubscriptions 필터에 리소스 URI를 넣어 subscriptions/listen 요청을 보낸다. 감시 중인 리소스가 바뀌면 서버는 해당 스트림으로 notifications/resources/updated를 전달한다.
여행 계획 예시에서 리소스는 AI 애플리케이션에 관련 정보 접근을 제공한다. 캘린더 데이터(calendar://events/2024)로 사용자 가용성을 확인하고, 여행 문서(file:///Documents/Travel/passport.pdf)로 중요 서류에 접근하며, 이전 일정(trips://history/barcelona-2023)으로 과거 여행과 선호를 참조한다. 애플리케이션은 이 리소스를 가져와 임베딩이나 키워드 검색으로 일부를 고르거나 원본을 그대로 모델에 전달하는 등 처리 방식을 정한다. 이 경우 캘린더 데이터, 날씨 정보, 여행 선호를 모델에 제공해 가용성 확인, 날씨 경향 조회, 과거 선호 참조를 가능하게 한다.
리소스 템플릿 예시는 다음과 같다.
```json
{
"uriTemplate": "weather://forecast/{city}/{date}",
"name": "weather-forecast",
"title": "Weather Forecast",
"description": "Get weather forecast for any city and date",
"mimeType": "application/json"
}
{
"uriTemplate": "travel://flights/{origin}/{destination}",
"name": "flight-search",
"title": "Flight Search",
"description": "Search available flights between cities",
"mimeType": "application/json"
}
```
이 템플릿은 유연한 질의를 가능하게 한다. 날씨는 도시와 날짜 조합의 예보를, 항공편은 두 공항 간 경로를 검색할 수 있다. 사용자가 출발지로 "NYC"를 입력하고 도착지로 "Bar"를 입력하기 시작하면 시스템이 "Barcelona (BCN)"이나 "Barbados (BGI)"를 제안할 수 있다.
동적 리소스는 매개변수 완성을 지원한다. weather://forecast/{city}에 "Par"를 입력하면 "Paris"나 "Park City"를 제안하고, flights://search/{airport}에 "JFK"를 입력하면 "JFK - John F. Kennedy International"을 제안하는 식이다. 정확한 형식을 몰라도 유효한 값을 찾도록 돕는다.
리소스는 애플리케이션이 제어하므로 검색, 처리, 표시 방식을 유연하게 정할 수 있다. 흔한 상호작용 방식은 폴더 같은 구조의 트리·목록 보기, 특정 리소스 검색·필터 인터페이스, 휴리스틱이나 AI 선택에 따른 자동 문맥 포함·스마트 제안, 단일·다중 리소스 선택 인터페이스 등이다. 프로토콜은 특정 UI 패턴을 강제하지 않으므로 미리보기가 있는 리소스 선택기, 대화 문맥 기반 제안, 다중 선택, 기존 파일 탐색기·데이터 탐색기 연동 등을 자유롭게 구현할 수 있다.
5. 프롬프트
프롬프트는 재사용 가능한 템플릿을 제공한다. MCP 서버 작성자가 도메인에 맞는 매개변수화된 프롬프트를 제공하거나 MCP 서버를 가장 잘 쓰는 방법을 보여줄 수 있게 한다.
프롬프트는 예상 입력과 상호작용 패턴을 정의한 구조화된 템플릿이다. 사용자가 제어하며 자동 실행이 아니라 명시적 호출이 필요하다. 문맥을 인식해 사용 가능한 리소스와 도구를 참조함으로써 포괄적인 워크플로를 만들 수 있다. 리소스처럼 매개변수 완성을 지원해 사용자가 유효한 인수 값을 찾도록 돕는다.
프로토콜 연산은 두 가지다.
- prompts/list: 사용 가능한 프롬프트를 탐색한다.
- prompts/get: 인수를 포함한 전체 프롬프트 정의를 가져온다.
여행 계획 맥락의 '휴가 계획' 프롬프트 예시는 다음과 같다.
```json
{
"name": "plan-vacation",
"title": "Plan a vacation",
"description": "Guide through vacation planning process",
"arguments": [
{ "name": "destination", "type": "string", "required": true },
{ "name": "duration", "type": "number", "description": "days" },
{ "name": "budget", "type": "number", "required": false },
{ "name": "interests", "type": "array", "items": { "type": "string" } }
]
}
```
비정형 자연어 입력 대신 프롬프트 시스템은 다음을 가능하게 한다. '휴가 계획' 템플릿을 선택하고, 바르셀로나, 7일, 3000달러, ["해변", "건축", "음식"] 같은 구조화된 입력을 넣고, 템플릿에 따라 일관된 워크플로를 실행한다.
프롬프트는 사용자가 제어하며 명시적 호출이 필요하다. 프로토콜은 구현자가 애플리케이션에 자연스러운 인터페이스를 설계하도록 자유를 준다. 핵심 원칙은 사용 가능한 프롬프트의 쉬운 탐색, 각 프롬프트의 명확한 설명, 검증이 포함된 자연스러운 인수 입력, 프롬프트에 깔린 템플릿을 투명하게 보여 주는 것이다. 애플리케이션은 보통 슬래시 명령(예: /plan-vacation), 검색 가능한 명령 팔레트, 자주 쓰는 프롬프트용 전용 버튼, 관련 프롬프트를 제안하는 문맥 메뉴 등으로 프롬프트를 노출한다.
6. 서버들을 함께 연결하기
MCP의 진짜 힘은 여러 서버가 함께 동작하며 특화된 기능을 통합 인터페이스로 결합할 때 드러난다.
개인화된 AI 여행 계획 애플리케이션에 세 서버가 연결된 경우를 보자. 여행 서버는 항공편, 호텔, 일정을 담당하고, 날씨 서버는 기후 데이터와 예보를 제공하며, 캘린더·이메일 서버는 일정과 커뮤니케이션을 관리한다.
전체 흐름은 다음과 같다.
1) 사용자가 매개변수와 함께 프롬프트를 호출한다.
```json
{
"prompt": "plan-vacation",
"arguments": {
"destination": "Barcelona",
"departure_date": "2024-06-15",
"return_date": "2024-06-22",
"budget": 3000,
"travelers": 2
}
}
```
2) 사용자가 포함할 리소스를 선택한다. calendar://my-calendar/June-2024(캘린더 서버), travel://preferences/europe(여행 서버), travel://past-trips/Spain-2023(여행 서버) 등이다.
3) AI가 도구로 요청을 처리한다. AI는 먼저 선택된 리소스를 모두 읽어 문맥을 모은다. 캘린더에서 가능한 날짜를 확인하고, 여행 선호에서 선호 항공사와 호텔 유형을 파악하며, 과거 여행에서 좋아했던 장소를 찾는다. 이 문맥으로 AI는 애플리케이션이 제공한 프롬프트를 실행한다. 예시에서 애플리케이션은 연결된 MCP 날씨 서버의 날씨 도구를 모델에 노출한다. 날씨가 여행 계획에 영향을 줄 수 있으므로 AI는 프롬프트를 해석할 때 checkWeather()를 호출하기로 한다. 그 결과 AI는 일련의 도구를 실행한다. searchFlights()는 NYC에서 바르셀로나로 가는 항공편을 조회하고, checkWeather()는 여행 날짜의 기후 예보를 가져온다. 이어 AI는 이 정보로 예약과 후속 단계를 진행하며 필요할 때 사용자 승인을 요청한다. bookHotel()은 예산 내 호텔을 찾고, createCalendarEvent()는 사용자 캘린더에 여행을 추가하며, sendEmail()은 여행 세부 정보가 담긴 확인 메일을 보낸다.
결과적으로 사용자는 여러 MCP 서버를 통해 자신의 일정에 맞춘 바르셀로나 여행을 조사하고 예약했다. '휴가 계획' 프롬프트는 AI가 여러 서버에 걸쳐 리소스(캘린더 가용성, 여행 이력)와 도구(항공편 검색, 호텔 예약, 캘린더 갱신)를 결합하도록 이끌었다. 문맥을 모으고 예약을 실행하는 이 작업은 몇 시간 걸릴 수도 있었지만 MCP를 통해 몇 분 만에 끝났다.
여러분은 MCP 서버를 직접 구성해 본 경험이나 궁금한 점이 있다면 댓글로 나눠 주세요.
---
출처: Model Context Protocol 문서 「MCP 서버 이해하기」 (Model Context Protocol 기여자)
https://modelcontextprotocol.io/docs/learn/server-concepts
라이선스: CC BY 4.0 https://creativecommons.org/licenses/by/4.0/deed.ko
변경 사항: 리퀘오 운영팀이 2026-11-10에 한국어로 번역하고 일부 축약·재구성했습니다. 원문 작성자가 이 번역을 보증하지 않습니다.
도움돼요 0 로그인하면 누를 수 있습니다. 로그인하면 저장하고 새 답글 알림을 받을 수 있습니다.
AI 차트 도구 (AI 요약·회원 리뷰·인기점수)
- @modelcontextprotocol/server npm · MCP 다른 글