로드 중

클라이언트의 프롬프트

강의 587분
로드 중

MCP 클라이언트를 구축하는 마지막 단계는 프롬프트 기능을 구현하는 것입니다. 이를 통해 서버에서 사용 가능한 모든 프롬프트를 나열하고, 변수가 보간된 특정 프롬프트를 가져올 수 있습니다.

List Prompts 구현하기

list_prompts 메서드는 간단합니다. 세션의 list prompts 메서드를 호출하고 프롬프트를 반환합니다:

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

개별 프롬프트 가져오기

get_prompt 메서드는 인자 보간을 처리하기 때문에 더 흥미롭습니다. 특정 프롬프트를 요청할 때, 프롬프트 함수에 주입되는 인자를 전달합니다. 예를 들어, 서버에 doc_id 매개변수를 기대하는 "format" 프롬프트가 있다면, 인자 딕셔너리에 해당 값을 제공합니다:

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

이 메서드는 Claude에 직접 입력할 준비가 된 대화를 구성하는 메시지를 반환합니다.

프롬프트 인자의 작동 방식

MCP 서버에서 프롬프트 함수를 정의하면, 모든 매개변수가 보간 변수로 사용 가능해집니다. get_prompt에 전달하는 인자 딕셔너리는 이러한 매개변수에 값을 제공합니다. 그러면 서버는 여러분의 값이 적절한 위치에 대체된 완전한 프롬프트를 생성합니다.

mcp_server.py 코드에서 "format" 프롬프트를 정의하는 모습: doc_id 인자가 document_id 태그 사이에 보간됩니다.

구현 테스트하기

구현이 완료되면 CLI를 통해 프롬프트를 테스트할 수 있습니다. 슬래시를 입력하면 사용 가능한 프롬프트가 명령어로 나타납니다. "format"과 같은 프롬프트를 선택하면 필요한 인자에 대한 값을 선택하라는 메시지가 표시됩니다(예: 포맷할 문서를 선택하는 것). 그러면 시스템은 다음을 수행합니다:

  1. 인자가 보간된 프롬프트를 가져옵니다
  2. 완전한 프롬프트를 Claude에게 전송합니다
  3. Claude가 요청을 완수하기 위해 필요한 도구 호출을 실행합니다
  4. 포맷된 결과를 반환합니다

MCP 서버 코드: @mcp.prompt는 format_document 함수를 사용하여 문서를 Markdown으로 다시 작성하는 "format" 프롬프트를 정의합니다.

실전에서의 프롬프트

프롬프트는 클라이언트가 호출할 수 있는 재사용 가능한 사용자 및 어시스턴트 메시지 세트를 정의합니다. 프롬프트는 고품질이어야 하며, 충분히 테스트되어야 하고, MCP 서버의 목적과 관련이 있어야 합니다. 이를 특정 작업을 완수하기 위해 서버의 도구와 리소스를 결합한 사전 구축된 워크플로우라고 생각하세요.

프롬프트 시스템은 프롬프트 로직(서버에서 정의됨)과 실행(클라이언트와 Claude가 처리함) 사이에 깔끔한 분리를 만듭니다. 이를 통해 사용자가 간단한 명령으로 실행할 수 있는 정교한 다단계 워크플로우를 쉽게 만들 수 있습니다.