로드 중
로드 중

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

우리가 만들 것

우리의 챗봇은 사용자가 일련의 문서와 대화할 수 있는 명령줄 인터페이스가 될 것입니다. 시스템에 포함될 내용은 다음과 같습니다:

  • CLI 기반 챗봇 인터페이스
  • Claude를 위한 문서 읽기 및 편집 기능
  • @doc_name 구문을 사용한 문서 "멘션" 기능
  • /command_name 구문을 사용한 명령 실행
  • 메모리에 저장된 가짜 문서 모음

프롬프트에 @를 입력하면 deposition.md, design.md, financials.md, outlook.md, plan.md, spec.md가 모두 "Resource"로 표시되어 나열됩니다.

시스템 아키텍처

이 프로젝트는 함께 작동하는 세 가지 주요 구성 요소로 이루어져 있습니다:

  • 우리의 MCP 클라이언트 - 사용자 상호작용 및 채팅 인터페이스 처리
  • 우리의 MCP 서버 - 문서 작업을 위한 도구 제공
  • 문서 저장소 - 다양한 파일 형식의 메모리 내 모음

우리 서버는 우리 MCP 클라이언트를 보유하고 있으며, 이 클라이언트는 우리 MCP 서버와 양방향으로 통신하고, 서버의 도구는 네 개의 문서를 읽고 업데이트합니다.

MCP 서버는 두 가지 핵심 도구를 구현할 것입니다:

  • 문서 내용을 읽는 도구
  • 문서 내용을 업데이트하는 도구

모든 문서(PDF, 스프레드시트, 텍스트 파일, 마크다운 파일)는 디스크가 아닌 메모리에 저장되어, 프로젝트를 단순하게 유지하고 MCP 개념에 집중할 수 있도록 합니다.

중요한 아키텍처 참고 사항

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

  • 다른 개발자에게 서비스를 배포하기 위한 MCP 서버 구축
  • 기존의 서드파티 MCP 서버에 연결하는 MCP 클라이언트 구축

우리 서버의 다이어그램으로, MCP 클라이언트를 포함하고 있으며 이 클라이언트는 별도의 MCP 서버에 양방향으로 연결됩니다.

우리 프로젝트는 순전히 교육 목적으로 단일 코드베이스에 두 구성 요소를 모두 구현하여, 클라이언트와 서버가 서로 어떻게 상호작용하는지 확인할 수 있도록 합니다.