프롬프트 정의하기

MCP 서버는 프롬프트를 정의할 수 있습니다 - 클라이언트가 직접 프롬프트를 처음부터 작성하는 대신 사용할 수 있는, 미리 작성된 고품질 지침입니다. 프롬프트를 사용자가 직접 작성할 수 있는 것보다 더 나은 결과를 제공하는 정교하게 만들어진 템플릿이라고 생각하세요.

프롬프트를 사용하는 이유는 무엇인가요?

Claude가 문서를 markdown으로 재구성하도록 하고 싶다고 가정해 보겠습니다. "report.pdf를 markdown으로 변환해줘"라고 간단히 요청해도 잘 작동할 것입니다. 하지만 엣지 케이스를 다루고 구체적인 서식 지침을 제공하는, 철저하게 테스트된 상세한 프롬프트를 사용하면 훨씬 더 나은 결과를 얻을 수 있을 것입니다.

아이디어는 간단합니다: MCP 서버 개발자로서, 우리는 정말 좋은 프롬프트를 만들고 테스트하는 데 시간을 투자한 다음, 이를 우리 서버를 사용하는 모든 사람이 이용할 수 있도록 제공할 수 있습니다. 사용자는 스스로 프롬프트 엔지니어링 전문가가 되지 않고도 더 나은 결과를 얻을 수 있습니다.

프롬프트는 도구 및 리소스와 유사한 데코레이터 패턴을 사용합니다. 기본 구조는 다음과 같습니다:

python

@mcp.prompt(
    name="format",
    description="Rewrites the contents of the document in Markdown format."
)
def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    # 메시지 목록을 반환합니다

이 함수는 Claude에게 직접 전송할 수 있는 메시지 목록을 반환합니다. 이를 통해 필요한 경우 여러 사용자 및 어시스턴트 메시지로 복잡한 프롬프트를 구축할 수 있습니다.

포맷 프롬프트 구축하기

문서 서버를 위해, 문서를 markdown으로 재구성하는 프롬프트를 만들어 보겠습니다. 이 프롬프트는 다음을 수행해야 합니다:

문서 ID를 입력으로 받기
read_doc_contents 도구를 사용하여 문서 가져오기
적절한 markdown 구문으로 재구성하기
변경 사항을 문서에 다시 저장하기

구현 방법은 다음과 같습니다:

python

def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.

The id of the document you need to reformat is:

{doc_id}


Add in headers, bullet points, tables, etc as necessary. Feel free to add in structure.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""
    
    return [
        base.UserMessage(prompt)
    ]

프롬프트 테스트하기

프롬프트를 정의한 후에는 MCP Inspector를 사용하여 테스트할 수 있습니다. Prompts 탭으로 이동하여 프롬프트를 선택하고 필요한 매개변수를 제공하세요.

Inspector는 Claude에게 전송될 생성된 메시지를 보여줍니다. 매개변수 보간이 올바르게 작동하는지, 그리고 프롬프트에 필요한 모든 지침이 포함되어 있는지 확인할 수 있습니다.

주요 이점

품질 관리 - 서버 작성자는 사용자가 보기 전에 프롬프트를 테스트하고 개선할 수 있습니다
일관성 - 모든 사람이 즉흥적으로 작성하는 대신 동일한 고품질 프롬프트를 받습니다
전문화 - 프롬프트는 서버의 특정 도메인과 기능에 맞게 조정될 수 있습니다
재사용성 - 여러 클라이언트 애플리케이션이 동일한 정교하게 만들어진 프롬프트를 사용할 수 있습니다

메시지 유형을 위한 기본 모듈을 가져오는 것을 잊지 마세요:

python

from mcp.server.fastmcp.prompts import base

프롬프트는 MCP 서버가 문서 관리, 데이터 분석, 코드 생성과 같은 특정 집중 영역을 가지고 있을 때 특히 유용합니다. 서버의 도구를 효과적으로 활용하는 실전 검증된 프롬프트를 사용자에게 제공할 수 있습니다.