로드 중
로드 중

MCP 클라이언트는 여러분의 서버와 MCP 서버 사이의 통신 브리지 역할을 합니다. MCP 서버가 제공하는 모든 도구에 접근할 수 있는 접점이라고 생각하면 됩니다. 외부 기능을 사용해야 할 때, 클라이언트가 모든 메시지 전달과 프로토콜 세부 사항을 대신 처리해 줍니다.

전송 방식에 구애받지 않는 통신

MCP의 핵심 강점 중 하나는 전송 방식에 구애받지 않는다는 점입니다. 이는 클라이언트와 서버가 다양한 통신 방법을 사용해 서로 통신할 수 있다는 것을 멋지게 표현한 말입니다. 가장 일반적인 구성은 MCP 클라이언트와 서버를 동일한 머신에서 실행하고, 표준 입출력을 통해 통신하는 방식입니다.

우리 서버는 MCP 클라이언트를 보유하고 있으며, 로컬에서 실행되는 GitHub MCP 서버와 표준 입출력을 통해 양방향으로 통신합니다.

하지만 이 방식에만 국한되지 않습니다. MCP 클라이언트와 서버는 다음을 통해서도 연결될 수 있습니다:

  • HTTP
  • WebSockets
  • 기타 다양한 네트워크 프로토콜

우리 서버에는 MCP 클라이언트가 포함되어 있으며, WebSockets를 통해 GitHub용 MCP 서버와 양방향으로 통신합니다.

메시지 유형

연결이 성립되면, 클라이언트와 서버는 MCP 명세에 정의된 특정 메시지 유형을 주고받습니다. 여러분이 주로 다루게 될 메시지 유형은 다음과 같습니다:

우리 서버의 MCP 클라이언트가 GitHub MCP 서버에 ListToolsRequest를 보내고, 서버는 ListToolsResult로 응답합니다.

ListToolsRequest/ListToolsResult: 클라이언트가 서버에 "어떤 도구들을 제공하나요?"라고 묻고, 사용 가능한 기능의 전체 목록을 받습니다.

우리 서버의 MCP 클라이언트가 GitHub MCP 서버에 ListToolsRequest를 보내고, 서버는 ListToolsResult로 응답합니다.

CallToolRequest/CallToolResult: 클라이언트가 서버에 "이 인자들로 이 특정 도구를 실행하라"고 지시하고, 실행 결과를 받습니다.

우리 서버는 MCP 클라이언트를 보유하고 있으며, GitHub용 MCP 서버에 CallToolRequest를 보내고 CallToolResult를 받습니다.

실제 예시 흐름

이 모든 요소들이 어떻게 함께 작동하는지 알아보기 위해 완전한 예시를 살펴보겠습니다. 사용자가 "내가 가진 저장소는 무엇인가요?"라고 묻는 상황을 상상해 보세요 - 전체 통신 체인은 다음과 같습니다:

사용자, 우리 서버, MCP 클라이언트, MCP 서버, GitHub 및 Claude의 시퀀스 다이어그램 생명선들로, 아직 아무 메시지도 오가지 않은 상태입니다.

이 과정은 사용자가 질문을 서버에 제출하면서 시작됩니다. 여러분의 서버는 AI 요청을 하기 전에 Claude에게 사용 가능한 도구를 제공해야 한다는 것을 인식합니다.

시퀀스 다이어그램: 사용자, 우리 서버, MCP 클라이언트, MCP 서버, GitHub 및 Claude, 사용자의 질문 화살표가 우리 서버로 향합니다.

여러분의 서버는 MCP 클라이언트에게 도구 목록을 요청하고, 이는 MCP 서버에 대한 ListToolsRequest를 촉발합니다. 서버는 사용 가능한 모든 도구가 담긴 ListToolsResult로 응답합니다.

시퀀스 다이어그램: 우리 서버가 MCP 클라이언트에게 Claude를 위한 도구가 필요하다고 알린 다음, ListToolsRequest와 ListToolsResult가 오갑니다.

이제 여러분의 서버는 초기 Claude 요청을 하는 데 필요한 모든 것, 즉 사용자의 질문과 사용 가능한 도구를 갖추게 되었습니다. Claude는 도구들을 분석하고, 질문에 제대로 답하기 위해 도구 하나를 호출해야 한다고 판단합니다.

도구 목록 교환의 시퀀스 다이어그램으로, 이제 우리 서버에서 Claude로 향하는 "쿼리 + 도구"라는 레이블이 붙은 화살표가 추가되었습니다.

Claude는 도구 사용 요청으로 응답합니다. 여러분의 서버는 이를 인식하고 MCP 클라이언트에게 Claude가 지정한 인자로 도구를 실행하도록 요청합니다.

시퀀스 다이어그램: 도구 목록 교환 이후, 우리 서버가 Claude에게 "쿼리 + 도구"를 보내고 Claude는 "도구 사용"으로 응답합니다.

MCP 클라이언트는 MCP 서버에 CallToolRequest를 보내고, 그러면 MCP 서버는 사용자의 저장소를 가져오기 위해 GitHub에 실제 API 호출을 합니다.

MCP 클라이언트에서 MCP 서버로의 CallToolRequest를 거쳐 GitHub로의 요청까지 이어지는 흐름의 시퀀스 다이어그램입니다.

GitHub는 저장소 데이터를 반환하고, MCP 서버는 이를 CallToolResult로 감싸서 체인을 통해 다시 전달합니다. 여러분의 서버는 이 데이터를 받아 이제 Claude에게 후속 요청을 할 수 있습니다.

사용자, 우리 서버, MCP 클라이언트, MCP 서버, Claude 및 GitHub 사이의 메시지를, 도구 결과까지의 시퀀스 다이어그램으로 나타냈습니다.

마지막 단계는 도구 결과를 사용자 메시지의 일부로 Claude에게 보냅니다. 이제 Claude는 사용자의 저장소에 대한 완전한 응답을 작성하는 데 필요한 모든 정보를 갖추게 되었습니다.

위에서 설명한, 사용자, 우리 서버, MCP 클라이언트, MCP 서버, Claude 및 GitHub 간의 전체 흐름에 대한 시퀀스 다이어그램입니다.

그렇습니다, 이 흐름에는 많은 단계가 포함되어 있지만, 이를 이해하면 여러분만의 MCP 클라이언트와 서버를 구현할 준비가 됩니다. 각 구성 요소는 특정한 역할을 가지고 있으며, 표준화된 메시지 유형은 기본 전송 메커니즘에 관계없이 모든 것이 원활하게 함께 작동하도록 보장합니다.