로드 중
로드 중

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

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

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

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

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

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

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

메시지 유형

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

우리 MCP 클라이언트가 GitHub용 MCP 서버로 ListToolsRequest를 보내면, 서버는 도구 목록이 담긴 ListToolsResult로 응답합니다.

ListToolsRequest/ListToolsResult: 클라이언트가 서버에 "어떤 도구를 제공하나요?"라고 물어보고 사용 가능한 도구 목록을 받습니다.

우리 MCP 클라이언트가 GitHub용 MCP 서버로 ListToolsRequest를 보내면, 서버는 도구 목록이 담긴 ListToolsResult로 응답합니다.

CallToolRequest/CallToolResult: 클라이언트가 서버에 특정 인자와 함께 특정 도구를 실행하도록 요청한 다음, 결과를 받습니다.

우리 서버의 MCP 클라이언트가 GitHub용 MCP 서버로 CallToolRequest를 보내면, 서버는 CallToolResult를 반환합니다.

전체 흐름 예시

실제 시나리오에서 이 모든 요소가 어떻게 함께 작동하는지 살펴보겠습니다. 사용자가 "내가 가진 저장소는 무엇인가요?"라고 묻는다고 가정해 봅시다 - 다음은 전체 통신 흐름입니다:

사용자, 우리 서버, MCP 클라이언트, MCP 서버, GitHub, Claude를 위한 열이 있는 흐름도로, 아직 메시지는 없습니다.

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

시퀀스 다이어그램에서 지금까지 유일한 화살표는 사용자가 우리 서버에 "내가 가진 저장소는 무엇인가요?"라고 묻는 것입니다.

여러분의 서버는 MCP 클라이언트에 도구를 요청하고, 클라이언트는 MCP 서버로 ListToolsRequest를 보내 ListToolsResult를 받습니다.

시퀀스 다이어그램: 우리 서버가 MCP 클라이언트에 "Claude에게 보낼 도구 목록이 필요합니다"라고 말하고, 클라이언트는 MCP 서버에 요청합니다.

이제 여러분의 서버는 Claude에게 초기 요청을 하는 데 필요한 모든 것, 즉 사용자의 질문과 사용 가능한 도구를 모두 갖추게 되었습니다.

시퀀스 다이어그램에서 우리 서버는 쿼리와 도구를 "쿼리 + 도구"라는 한 단계로 Claude에게 보냅니다.

Claude는 도구들을 검토하고 질문에 답하기 위해 도구를 하나 호출해야 한다고 판단합니다. Claude는 도구 사용 요청으로 응답합니다.

흐름도: Claude의 ToolUse 이후, 우리 서버는 MCP 클라이언트에 "이 인자로 이 도구를 실행해 주세요"라고 말합니다.

여러분의 서버는 MCP 클라이언트에 Claude가 요청한 도구를 실행하도록 요청합니다. MCP 클라이언트는 MCP 서버로 CallToolRequest를 보내고, MCP 서버는 GitHub에 실제 요청을 합니다.

User부터 GitHub까지 여섯 개의 레인에 걸친 시퀀스 다이어그램으로, CallToolRequest와 MCP 서버의 GitHub 요청으로 끝납니다.

GitHub가 저장소 데이터를 반환하면, 이 데이터는 MCP 서버를 거쳐 CallToolResult로, 그다음 MCP 클라이언트로, 마지막으로 여러분의 서버로 흘러갑니다.

저장소 쿼리의 시퀀스 다이어그램으로, 이제 우리 서버가 Claude에게 보내는 toolResult 메시지가 추가되었습니다.

여러분의 서버는 후속 메시지로 도구 결과를 다시 Claude에게 보냅니다. 이제 Claude는 완전한 응답을 작성하는 데 필요한 모든 정보를 갖추게 되었습니다.

"당신의 저장소는"으로 시작하는 Claude의 답변이 여러분의 서버를 거쳐 사용자에게 전달되며 끝나는 전체 시퀀스 다이어그램.

마지막으로, Claude는 정리된 답변으로 응답하고, 여러분의 서버는 이를 사용자에게 다시 전달합니다.

네, 이 흐름에는 많은 단계가 포함되어 있지만, 각 구성 요소는 명확한 책임을 지니고 있습니다. MCP 클라이언트는 서버 통신의 복잡성을 추상화해 주어, 여러분이 애플리케이션 로직을 구축하는 데 집중할 수 있게 해줍니다. 우리가 직접 MCP 클라이언트와 서버를 구현하면서, 각 부분이 실제로 어떻게 맞물려 작동하는지 보게 될 것입니다.