로드 중
로드 중

MCP 클라이언트와 서버가 어떻게 함께 작동하는지 더 잘 이해하기 위해 CLI 기반 챗봇을 만들어보겠습니다. 이 실습 프로젝트를 통해 MCP 아키텍처의 양쪽 모두에 대한 실전 경험을 쌓을 수 있습니다.

설정이 완료되면, 두 가지를 할 수 있어야 합니다: 클라이언트가 하는 일과 서버가 하는 일을 설명할 수 있어야 하고, 응답이 도구를 거쳐 왔는지 아니면 모델에서 직접 왔는지 구분할 수 있어야 합니다.

우리가 만들 것

우리의 챗봇은 사용자가 명령줄 인터페이스를 통해 문서 모음과 상호작용할 수 있게 해줍니다. 이 시스템은 두 가지 주요 구성 요소로 이루어져 있습니다:

  • 사용자 상호작용을 처리하는 MCP 클라이언트
  • 문서 작업을 관리하는 커스텀 MCP 서버

우리의 MCP 클라이언트는 MCP 서버와 양방향으로 통신하며, 이 서버의 도구는 document.pdf, spreadsheet.xlsx, report.txt, spec.md에 접근합니다.

서버는 두 가지 핵심 도구를 제공합니다: 하나는 문서 내용을 읽기 위한 것이고, 다른 하나는 문서를 업데이트하기 위한 것입니다. 모든 문서는 단순화를 위해 메모리에 저장되며, 데이터베이스는 필요하지 않습니다.

중요한 아키텍처 참고 사항

실제 프로젝트에서는 일반적으로 MCP 클라이언트나 MCP 서버 중 하나만 구현하며, 둘 다 구현하지는 않습니다. 다음과 같이 만들 수 있습니다:

  • 다른 개발자에게 서비스를 노출하기 위한 MCP 서버
  • 기존 MCP 서버에 연결하기 위한 MCP 클라이언트

우리의 서버는 MCP 클라이언트를 포함하고 있으며, 이 클라이언트는 별도의 MCP 서버와 양방향으로 통신합니다.

이 프로젝트에서는 순전히 교육적인 목적으로 두 구성 요소를 모두 만들어, 이들이 어떻게 통신하고 함께 작동하는지 이해하고자 합니다.

프로젝트 설정

이 레슨 끝부분의 다운로드 섹션에서 cli_project.zip을 다운로드하여 원하는 개발 디렉터리에 압축을 풀어주세요. 프로젝트 폴더에서 코드 에디터를 엽니다.

프로젝트에는 설정 지침이 포함된 자세한 README 파일이 들어 있습니다. 다음 단계를 따라주세요:

  1. .env 파일에 Anthropic API 키를 추가합니다
  2. UV(권장) 또는 pip를 사용하여 의존성을 설치합니다
  3. 시작 애플리케이션을 실행하여 모든 것이 제대로 작동하는지 확인합니다

애플리케이션 실행

터미널에서 프로젝트 디렉터리로 이동합니다. main.py, mcp_client.py, mcp_server.py를 포함한 주요 프로젝트 파일들을 확인할 수 있습니다.

애플리케이션을 시작하려면 다음 명령어 중 하나를 사용하세요:

bash
# UV를 사용하는 경우 (권장)
uv run main.py

# 표준 Python을 사용하는 경우
python main.py

애플리케이션이 성공적으로 시작되면 채팅 프롬프트가 표시됩니다.

직접 기준선을 확인해보세요. 눈으로 바로 확인할 수 있는 질문을 입력해보세요. 예를 들어 "1+1은 뭐야?" 같은 질문입니다. 단순히 응답이 나오는 것에 만족하지 말고, 답이 실제로 2인지 확인하세요. 올바른 응답은 API 키, 의존성, 채팅 루프가 모두 제대로 작동한다는 것을 증명합니다.

그런 다음 "문서에는 뭐라고 적혀 있어?" 같은 두 번째 질문을 입력해보세요. 어떤 응답이 돌아오든, 아직 문서 도구를 만들지 않았기 때문에 그 응답은 문서 도구에서 온 것일 수 없습니다. 이 응답은 모델이 스스로 답한 것입니다. 이 구성 요소가 존재하게 되면 어느 쪽이 그 작업을 담당하게 될지 주목하세요: 서버는 문서 작업을 관리하고, 클라이언트는 대화의 당신 쪽을 처리합니다.

이 확인의 핵심 습관은 다음과 같습니다: 확인을 얼마나 철저히 할지는 틀렸을 때의 비용에 맞춰야 합니다. 여기서 잘못된 설정은 이후의 모든 레슨에 영향을 미치는 비용을 초래하지만, 확인하는 데는 질문 두 개면 충분합니다.

계속 유지할 가치가 있는 확인 습관

이 프로젝트를 넘어서도 계속 가져가야 할 행동이 있습니다: API 프로젝트에 도구든, 데이터 소스든, MCP 서버든 새로운 계층을 추가할 때마다, 다음 계층을 만들기 전에 이미 답을 알고 있는 질문 하나를 실행 중인 시스템에 던져보세요. 직접 검증한 기준선만이 디버깅의 기준으로 삼을 수 있는 기준선입니다.

기본 설정이 완료되었으니, 이제 MCP 기능을 구현하고 Model Context Protocol을 통해 클라이언트와 서버가 어떻게 통신하는지 탐구할 준비가 되었습니다.

다운로드

  • Starter project (cli_project.zip)

    The chatbot project you build on for the rest of this section.

    다운로드
  • Completed project (cli_project_COMPLETE.zip)

    The finished version, for checking your work.

    다운로드