MCP 서버 이해

MCP 서버는 표준화된 프로토콜 인터페이스를 통해 AI 애플리케이션에 특정 기능들을 제공하는 프로그램입니다.

일반적인 예로는 문서에 접근하기 위한 파일 시스템 서버, 데이터 조회를 위한 데이터베이스 서버, 코드 관리를 위한 GitHub 서버, 팀 간 커뮤니케이션을 위한 Slack 서버, 그리고 일정 관리를 위한 캘린더 서버가 있습니다.

핵심 서버 기능

서버는 세 가지 구성 요소를 통해 다양한 기능을 제공합니다.

기능	설명	예시	제어 주체
도구	LLM이 사용자 요청에 따라 능동적으로 호출할 수 있는 함수입니다. 데이터베이스에 데이터를 저장하거나 외부 API를 호출하고, 파일을 수정하거나 기타 로직을 실행할 수 있습니다.	항공편 검색 메시지 전송 캘린더 이벤트 생성	모델
리소스	파일 내용, 데이터베이스 스키마, API 문서처럼 컨텍스트를 제공하는 읽기 전용 정보의 수동형 데이터 소스입니다.	문서 가져오기 지식 베이스 접근 캘린더 읽기	애플리케이션
프롬프트	모델이 특정 도구와 리소스를 사용하도록 안내하는 사전 작성된 지침 템플릿입니다.	휴가 계획 세우기 회의 요약하기 이메일 초안 작성	사용자

각 기능의 역할을 보여주고 이들이 어떻게 함께 작동할 수 있는지 설명하기 위해 가상의 시나리오를 활용하겠습니다.

도구

도구는 AI 모델이 특정 작업을 수행할 수 있도록 해줍니다. 각 도구는 유형이 지정된 입력과 출력을 가진 특정 작업을 정의하며, 모델은 상황에 따라 도구 실행을 요청합니다.

도구의 작동 원리

도구는 LLM이 호출할 수 있는 스키마로 정의된 인터페이스입니다. MCP는 유효성 검사를 위해 JSON Schema를 사용하며, 각 도구는 명확하게 정의된 입력과 출력을 가진 단일 작업만을 수행합니다. 도구는 실행 전에 사용자의 동의를 요구할 수 있어, 사용자가 모델이 수행하는 작업에 대한 통제권을 유지할 수 있도록 도와줍니다.

프로토콜 작업:

메서드	목적	반환 값
`tools/list`	사용 가능한 도구 검색	스키마가 포함된 도구 정의 배열
`tools/call`	특정 도구 실행	도구 실행 결과

도구 정의 예시:

{
  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 애플리케이션은 사용자를 대신하여 다양한 작업을 수행할 수 있습니다. 여행 계획 수립 시나리오에서 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에 사용 가능한 도구들을 표시합니다.
개별 도구 실행 시 승인 대화상자를 표시합니다.
특정 안전한 작업을 사전에 승인하기 위한 권한 설정 기능을 제공합니다.
모든 도구 실행 내역과 그 결과를 보여주는 활동 로그를 제공합니다.

리소스

리소스는 AI 애플리케이션이 가져와 모델에 컨텍스트로 제공할 수 있는 정보에 대한 구조화된 접근 방식을 제공합니다.

리소스의 작동 원리

리소스는 AI가 맥락을 이해하는 데 필요한 파일, API, 데이터베이스 또는 기타 모든 출처의 데이터를 노출합니다. 애플리케이션은이 정보에 직접 접근하여 관련 부분만 선별하거나, 엠베딩을 활용해 검색하거나, 모든 정보를 모델에 전달하는 등 자신에게 적합한 방식으로 이를 활용할 수 있습니다.

각 리소스에는 고유한 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) - 과거의 여행 기록 및 선호 사항 참조

AI 애플리케이션은 이러한 리소스들을 가져온 뒤, 엠베딩이나 키워드 검색을 활용해 데이터의 일부만 선별하거나 원시 데이터를 그대로 모델에 전달하는 방식 등으로 이를 어떻게 처리할지 결정합니다.

이 경우, 모델에 일정 데이터, 날씨 정보, 그리고 여행 선호 사항을 제공함으로써 모델이 가용 시간을 확인하고 날씨 패턴을 조회하며 과거의 여행 선호 사항을 참조할 수 있도록 합니다.

리소스 템플릿 예시:

{
  "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"
}

이러한 템플릿들을 통해 유연한 조회가 가능합니다. 날씨 데이터의 경우 사용자는 원하는 도시와 날짜 조합에 대한 예보를 확인할 수 있으며, 항공편의 경우 두 공항 간의 노선을 검색할 수 있습니다. 사용자가 origin 공항으로 "NYC"를, destination 공항으로 "Bar"를 입력하기 시작하면, 시스템은 "Barcelona (BCN)" 또는 "Barbados (BGI)"를 제안할 수 있습니다.

매개변수 자동 완성

동적 리소스는 매개변수 자동 완성 기능을 지원합니다. 예를 들어 다음과 같습니다.

weather://forecast/{city}에 대해 "Par"라고 입력하면 "Paris" 또는 "Park City"가 제안될 수 있습니다.
flights://search/{airport}에 대해 "JFK"라고 입력하면 "JFK - John F. Kennedy International"이 제안될 수 있습니다.

이 시스템은 정확한 형식에 대한 지식이 없어도 유효한 값들을 찾는 데 도움을 줍니다.

사용자 상호작용 모델

리소스는 애플리케이션에 의해 구동되므로, 사용 가능한 컨텍스트를 가져오고 처리하며 표시하는 방식에 있어서 유연성을 가집니다. 일반적인 상호작용 패턴에는 다음과 같은 것들이 있습니다.

익숙한 폴더 구조와 유사한 형태로 리소스를 브라우징할 수 있는 트리 또는 목록 보기
특정 리소스를 찾기 위한 검색 및 필터링 인터페이스
휴리스틱이나 AI 기반 선택 방식을 활용한 자동 컨텍스트 포함 기능 또는 스마트 제안 기능
단일 리소스나 여러 리소스를 포함시키기 위한 수동 또는 대량 선택 인터페이스

애플리케이션은 자신의 요구사항에 맞는 어떠한 인터페이스 패턴을 통해서든 리소스 발견 기능을 구현할 수 있습니다. 이 프로토콜은 특정 UI 패턴을 강제로 규정하지 않으므로, 미리보기 기능이 포함된 리소스 선택기, 현재 대화 컨텍스트를 기반으로 한 스마트 제안 기능, 여러 리소스를 한꺼번에 선택하는 기능, 또는 기존의 파일 브라우저 및 데이터 탐색 도구와의 통합도 가능합니다.

프롬프트

프롬프트는 재사용 가능한 템플릿을 제공합니다. 이를 통해 MCP 서버 개발자들은 특정 도메인에 맞는 매개변수가 포함된 프롬프트를 제공하거나 MCP 서버를 가장 효과적으로 활용하는 방법을 보여줄 수 있습니다.

프롬프트의 작동 원리

프롬프트는 예상되는 입력값과 상호작용 패턴을 정의하는 구조화된 템플릿입니다. 이는 사용자가 직접 제어해야 하며 자동으로 실행되는 것이 아니라 명시적으로 호출되어야 합니다. 프롬프트는 컨텍스트를 인식할 수 있어, 사용 가능한 리소스와 도구를 참조하여 포괄적인 워크플로우를 구축할 수 있습니다. 리소스와 마찬가지로 프롬프트도 매개변수 자동 완성 기능을 지원하여 사용자가 유효한 인수 값을 찾는 데 도움을 줍니다.

프로토콜 작업:

메서드	용도	반환 값
`prompts/list`	사용 가능한 프롬프트 조회	프롬프트 설명자 배열
`prompts/get`	프롬프트 상세 정보 가져오기	인수와 함께 제공되는 완전한 프롬프트 정의

예시: 효율적인 워크플로우

프롬프트는 일반적인 작업에 사용할 수 있는 구조화된 템플릿을 제공합니다. 여행 계획과 관련된 상황에서는 다음과 같습니다:

"휴가 계획 세우기" 프롬프트:

{
  "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, ["해변", "건축", "음식"]
템플릿을 기반으로 한 일관된 워크플로우 실행

사용자 상호작용 모델

프롬프트는 클라이언트가 직접 제어하며 명시적인 호출이 필요합니다. 이 프로토콜은 구현자들이 자신들의 애플리케이션 내에서 자연스럽게 느껴지는 인터페이스를 설계할 수 있는 자유를 제공합니다. 주요 원칙은 다음과 같습니다:

사용 가능한 프롬프트의 쉬운 발견
각 프롬프트가 수행하는 역할에 대한 명확한 설명
유효성 검사가 포함된 자연스러운 인자 입력
프롬프트의 기반이 되는 템플릿의 투명한 표시

애플리케이션들은 일반적으로 다음과 같은 다양한 UI 패턴을 통해 프롬프트를 노출합니다:

슬래시 명령어 (/plan-vacation과 같은 사용 가능한 프롬프트를 보려면 "/"를 입력함)
검색이 가능한 명령어 팔레트
자주 사용되는 프롬프트를 위한 전용 UI 버튼
관련 프롬프트를 제안하는 컨텍스트 메뉴

서버들의 연결

MCP의 진정한 힘은 여러 서버가 통합된 인터페이스를 통해 각자의 전문적인 기능들을 결합하여 함께 작동할 때 발휘됩니다.

예시: 다중 서버 기반 여행 계획 수립

세 대의 서버가 연동되어 있는 맞춤형 AI 여행 계획 수립 애플리케이션을 생각해 보겠습니다.

여행 서버 - 항공편, 호텔, 일정 관리
날씨 서버 - 기후 데이터 및 일기 예보 제공
캘린더/이메일 서버 - 일정 관리 및 커뮤니케이션 처리

전체 처리 흐름

사용자가 매개변수가 포함된 프롬프트를 전송합니다.

{
  "prompt": "plan-vacation",
  "arguments": {
    "destination": "Barcelona",
    "departure_date": "2024-06-15",
    "return_date": "2024-06-22",
    "budget": 3000,
    "travelers": 2
  }
}

사용자가 포함할 리소스를 선택합니다:
- calendar://my-calendar/June-2024 (캘린더 서버에서 제공)
- travel://preferences/europe (여행 서버에서 제공)
- travel://past-trips/Spain-2023 (여행 서버에서 제공)
AI가 도구들을 활용하여 요청을 처리합니다.

먼저 AI는 컨텍스트를 수집하기 위해 선택된 모든 리소스를 읽어들입니다. 이때 달력에서 사용 가능한 날짜를 파악하고, 여행 선호도를 통해 선호하는 항공사와 호텔 유형을 학습하며, 과거 여행 기록에서 즐겨 찾았던 장소들을 발견합니다.

이렇게 수집된 컨텍스트를 바탕으로 AI는 AI 애플리케이션이 제공한 프롬프트를 실행합니다. 예시에서는 AI 애플리케이션이 연결된 MCP 날씨 서버의 날씨 관련 도구들을 모델에 제공합니다. 날씨가 여행 계획에 영향을 미칠 수 있으므로, AI는 프롬프트를 해석할 때 checkWeather()을 호출하기로 결정합니다.

그 결과 AI는 일련의 도구들을 실행합니다.
- searchFlights() - 뉴욕에서 바르셀로나로 가는 항공편 정보를 항공사에 문의합니다.
- checkWeather() - 여행 예정일에 해당하는 기후 예보 정보를 가져옵니다.
그 후 AI는 이 정보를 활용해 다음 예약 작업을 수행하며, 필요하면 사용자에게 승인을 요청합니다.
- bookHotel() - 지정된 예산 범위 내의 호텔을 찾습니다.
- createCalendarEvent() - 여행 일정을 사용자의 달력에 추가합니다.
- sendEmail() - 여행 세부 정보가 포함된 확인 메시지를 전송합니다.

결과: 여러 MCP 서버를 통해 사용자는 자신의 일정에 맞춰 바르셀로나 여행을 조사하고 예약할 수 있었습니다. "휴가 계획 세우기" 프롬프트는 AI가 서로 다른 서버에 존재하는 리소스(달력의 가용성 및 여행 이력)와 도구(항공편 검색, 호텔 예약, 달력 업데이트)를 결합하여 컨텍스트를 수집하고 예약을 실행하도록 안내했습니다. 원래 몇 시간이 걸릴 수 있었던 작업이 MCP를 활용하여 단 몇 분 만에 완료되었습니다.

핵심 서버 기능​

도구​

도구의 작동 원리​

예시: 여행 예약​

사용자 상호작용 모델​

리소스​

리소스의 작동 원리​

예시: 여행 계획 관련 컨텍스트 가져오기​

매개변수 자동 완성​

사용자 상호작용 모델​

프롬프트​

프롬프트의 작동 원리​

예시: 효율적인 워크플로우​

사용자 상호작용 모델​

서버들의 연결​

예시: 다중 서버 기반 여행 계획 수립​

전체 처리 흐름​

핵심 서버 기능

도구

도구의 작동 원리

예시: 여행 예약

사용자 상호작용 모델

리소스

리소스의 작동 원리

예시: 여행 계획 관련 컨텍스트 가져오기

매개변수 자동 완성

사용자 상호작용 모델

프롬프트

프롬프트의 작동 원리

예시: 효율적인 워크플로우

사용자 상호작용 모델

서버들의 연결

예시: 다중 서버 기반 여행 계획 수립

전체 처리 흐름