로드 중

클라이언트에서의 프롬프트

강의 577분
로드 중

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

프롬프트 목록 구현하기

list_prompts 메서드는 간단합니다. 세션의 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에 바로 입력할 수 있는 대화를 구성하는 메시지를 반환합니다.

프롬프트 작동 테스트하기

클라이언트를 실행하고 슬래시(/)를 입력하면, 사용 가능한 프롬프트가 명령어로 표시됩니다. "format"과 같은 프롬프트를 선택하면 사용 가능한 문서 중에서 선택하라는 메시지가 표시됩니다. 그러면 시스템은 다음과 같이 동작합니다:

  • 문서 ID가 보간된 프롬프트를 가져옵니다
  • 이를 사용자 메시지로 Claude에 바로 전달합니다
  • Claude는 지침과 문서 ID를 모두 받습니다
  • Claude는 사용 가능한 도구를 사용해 문서 내용을 가져옵니다
  • Claude는 재구성된 결과로 응답합니다

클라이언트에서 슬래시를 입력하면 "/format"이 나열되며, 이는 문서 내용을 Markdown 형식으로 다시 작성합니다.

프롬프트 작동 방식

프롬프트는 클라이언트가 사용할 수 있는 사용자 및 어시스턴트 메시지 집합을 정의합니다. 이러한 프롬프트는 품질이 높고, 충분히 테스트되었으며, MCP 서버의 전반적인 목적과 관련이 있어야 합니다.

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

작업 흐름은 다음과 같습니다:

  1. MCP 서버의 목적과 관련된 프롬프트를 작성하고 평가합니다
  2. @mcp.prompt 데코레이터를 사용하여 MCP 서버 내부에 프롬프트를 정의합니다
  3. 클라이언트는 언제든지 해당 프롬프트를 요청할 수 있습니다
  4. 프롬프트를 요청할 때, 프롬프트 함수에 키워드 인자로 전달될 인자를 제공합니다
  5. 함수는 해당 인자를 사용하여 프롬프트 내용을 맞춤화합니다

이 시스템은 재사용 가능하고 매개변수화된 프롬프트를 만들어, 다양한 클라이언트와 사용 사례에서 공유할 수 있게 하며, MCP 서버를 더욱 다재다능하고 강력하게 만들어 줍니다.