Prompts ใน MCP Servers

Model Context Protocol (MCP) เบื้องต้น

James Chapman

AI Curriculum Manager, DataCamp

MCP Prompts คืออะไร?

Prompts: เทมเพลตที่นำกลับมาใช้ซ้ำได้ เพื่อปรับ LLM ให้เหมาะกับงานเฉพาะ

กำหนด workflow และพฤติกรรม
ลดภาระการเขียน prompt ของผู้ใช้

ความจำเป็นในการใช้ Prompting

Prompt สำหรับ Timezone Converter

You are a timezone conversion engine.

Your task is to:
1. Extract the source datetime from the user's natural language input.
2. Identify the source timezone (explicit or inferred).
3. Convert the datetime into the target timezone.

Rules:
- If the date is ambiguous (e.g., "next Friday"), resolve it relative to the provided datetime.
- If the input cannot be resolved confidently, seek clarification.

→ เปิดเผย prompt นี้สำหรับงานแปลง timezone

การกำหนด Prompts ใน MCP Server

@mcp.prompt(title="Timezone Conversion")

def convert_timezone_prompt(user_input: str) -> str:

    return f"""You are a timezone conversion engine.

Your task is to:
1. Extract the source datetime...

Rules:
- If the date is ambiguous (e.g., "next Friday"), resolve it relative to the provided datetime.
- If the input cannot be resolved confidently, seek clarification.

    User's timezone conversion request: {user_input}"""

MCP Server ในเครื่อง: timezone_server.py

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("Timezone Converter")

# Tools and resources from before...

@mcp.prompt(title="Timezone Conversion")
def convert_timezone_prompt(timezone_request: str) -> str:
    # ...

if __name__ == "__main__":
    mcp.run(transport="stdio")

Client: แสดงรายการ Prompts

async def list_prompts():
    """List all available prompts from the MCP server."""
    params = StdioServerParameters(command=sys.executable, args=["timezone_server.py"])

    async with stdio_client(params) as (reader, writer):
        async with ClientSession(reader, writer) as session:
            await session.initialize()

            # List available prompts
            prompts = await session.list_prompts()
            print(f"Available prompts: {[p.name for p in prompts.prompts]}")

Client: แสดงรายการ Prompts

print(asyncio.run(list_prompts()))

Available prompts: ['convert_timezone_prompt']

name ของ prompt ไม่เหมือนกับ title

@mcp.prompt(title="Timezone Conversion")
def convert_timezone_prompt(timezone_request: str) -> str:
    # ...

Client: แสดงรายการ Prompts

print(asyncio.run(list_prompts()))

Available prompts: ['convert_timezone_prompt']

name ของ prompt ไม่เหมือนกับ title

# List available prompts
prompts = await session.list_prompts()
print(f"Available prompts: {[p.name for p in prompts.prompts]}")

ใช้ attribute .name ใน client (ไม่ใช่ .title)

Client: ดึงข้อมูล Prompts

async def read_prompt(user_input: str, prompt_name: str = "convert_timezone_prompt") -> str:
    """Retrieve a prompt from the MCP server with user input."""
    params = StdioServerParameters(command=sys.executable, args=["timezone_server.py"])

    async with stdio_client(params) as (reader, writer):
        async with ClientSession(reader, writer) as session:
            await session.initialize()

            prompts = await session.list_prompts()

            # Retrieve the prompt
            if prompts.prompts:
                prompt = await session.get_prompt(prompt_name, arguments={"timezone_request": user_input})

                print(f"Prompt result: {prompt.messages[0].content.text}")

            return prompt.messages[0].content.text

print(asyncio.run(read_prompt(user_input="It is 9:50 AM in the UK in January. What time is
    it in Lisbon, Portugal?")))

You are a timezone conversion engine.

Your task is to:
1. Extract the source datetime from the user's natural language input.
2. Identify the source timezone (explicit or inferred).
3. Convert the datetime into the target timezone.

Rules:
- If the date is ambiguous (e.g., "next Friday"), resolve it relative to the...
- If the input cannot be resolved confidently, seek clarification.

User's timezone conversion request: It is 9:50 AM in the UK in January. What time is it in
Lisbon, Portugal?

ฝึกปฏิบัติกันเลย!

Model Context Protocol (MCP) เบื้องต้น