로드 중

클라이언트의 프롬프트

강의 569분
로드 중

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

문서의 내용을 Markdown 형식으로 다시 작성하는 "format"이라는 이름의 프롬프트를 정의하는 MCP 서버 코드.

List Prompts 구현하기

첫 번째 단계는 MCP 클라이언트에서 list_prompts 메서드를 구현하는 것입니다. 이 메서드는 서버에서 사용 가능한 모든 프롬프트를 가져옵니다:

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

이 간단한 구현은 세션의 list_prompts 메서드를 호출하고 결과에서 프롬프트 배열을 반환합니다.

개별 프롬프트 가져오기

get_prompt 메서드는 인자가 보간된 특정 프롬프트를 가져옵니다. 프롬프트를 요청할 때, 프롬프트 함수에 키워드 인자로 전달될 인자를 제공합니다:

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에 바로 입력할 수 있는 대화를 구성합니다.

프롬프트 인자의 작동 방식

서버 측에서 프롬프트 함수를 정의할 때, 해당 함수는 매개변수를 받을 수 있습니다. 예를 들어, 문서 서식 지정 프롬프트는 doc_id 매개변수를 받을 수 있습니다:

python
def format_document(doc_id: str):
    # doc_id는 프롬프트에 보간됩니다

클라이언트가 get_prompt를 호출할 때, 인자 딕셔너리에는 예상되는 키가 포함되어야 합니다. MCP 서버는 이를 프롬프트 함수에 키워드 인자로 전달하여, 프롬프트 템플릿에 동적 콘텐츠를 삽입할 수 있게 합니다.

CLI에서 프롬프트 테스트하기

구현이 완료되면, 명령줄 인터페이스를 통해 프롬프트를 테스트할 수 있습니다. 슬래시를 입력하면 사용 가능한 프롬프트가 명령어로 표시됩니다. 프롬프트를 선택하면 사용 가능한 옵션(예: 문서 ID) 중에서 선택하라는 메시지가 표시될 수 있으며, 이후 완성된 프롬프트가 Claude로 전송됩니다.

uv run main.py를 실행 중인 터미널에 "/format plan.md"가 입력되어 있고, plan.md가 강조 표시된 파일 자동완성 목록.

작동 방식은 다음과 같습니다:

  1. 사용자가 프롬프트를 선택합니다(예: "format")
  2. 시스템이 필요한 인자를 요청합니다(예: 어떤 문서를 형식화할지)
  3. 보간된 값과 함께 프롬프트가 Claude로 전송됩니다
  4. Claude는 도구를 사용하여 추가 데이터를 가져오고 작업을 완료할 수 있습니다

"Development Team 5 FTE Phases 1-5"라는 리소스 테이블 행과 Risk Management 섹션이 있는 터미널 markdown.

프롬프트 모범 사례

MCP 서버용 프롬프트를 작성할 때:

  • 서버의 목적과 관련성이 있도록 만드세요
  • 배포 전에 철저히 테스트하세요
  • 명확하고 구체적인 지침을 사용하세요
  • 사용 가능한 도구와 잘 작동하도록 설계하세요
  • 사용자가 제공해야 할 인자가 무엇인지 고려하세요

프롬프트는 사전에 정의된 기능과 동적인 사용자 요구 사이의 간극을 메워주며, 매개변수화를 통한 유연성을 유지하면서도 Claude에게 복잡한 작업을 위한 구조화된 출발점을 제공합니다.