MCP Academy · บทเรียน

เพิ่มเครื่องมือทักทาย

ตกแต่งฟังก์ชัน Python เพื่อให้ปัญญาประดิษฐ์เรียกใช้ได้

บทเรียน 2 จาก 413 ขั้นตอน

เพิ่มเครื่องมือทักทาย เป็นบทเรียน MCP Academy ฟรีบน CoddyKit นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน คุณสามารถอ่านบทเรียนทั้งหมดด้านล่างฟรี — จากนั้นลองปฏิบัติด้วยตัวคุณเองในเบราว์เซอร์พร้อมตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7 บทเรียนนี้เป็นส่วนหนึ่งของเส้นทางการเรียน MCP Academy และความก้าวหน้าของคุณจะซิงค์ข้ามเว็บและแอป CoddyKit คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน

มอบทักษะให้เซิร์ฟเวอร์

เซิร์ฟเวอร์ที่ไม่มีเครื่องมือก็เป็นเพียงโครงเปล่า เครื่องมือคือฟังก์ชัน Python ที่ AI เรียกใช้เพื่อทำบางสิ่งให้ผู้ใช้ได้จริง 🛠️

มัณฑนากรเวทมนตร์

FastMCP เปิดเผยฟังก์ชันให้เป็นเครื่องมือได้ด้วยบรรทัดเดียว นั่นคือมัณฑนากร @mcp.tool() ที่วางไว้เหนือคำจำกัดความของฟังก์ชันโดยตรง

@mcp.tool()
def hello():
    ...

เขียนฟังก์ชันตามปกติ

เนื้อหาภายในเป็นเพียงPython ไม่มีโค้ดโปรโตคอลพิเศษ และไม่ต้องเขียน JSON เอง คุณเขียนสิ่งที่เครื่องมือควรทำ แล้วส่งค่ากลับ

@mcp.tool()
def hello():
    return "Hello from MCP!"

เพิ่มพารามิเตอร์

เครื่องมือจะมีประโยชน์มากขึ้นเมื่อรับข้อมูลเข้า เพิ่มพารามิเตอร์ แล้วโมเดลจะส่งค่าเข้ามาได้เมื่อมันตัดสินใจเรียกใช้เครื่องมือของคุณ

@mcp.tool()
def greet(name):
    return "Hello, " + name

คำใบ้ชนิดข้อมูลสร้างสคีมา

เพิ่มคำใบ้ชนิดข้อมูล เช่น name: str แล้ว FastMCP จะแปลงเป็นสคีมาข้อมูลเข้า จากนั้นโมเดลจะทราบอย่างแน่ชัดว่าควรส่งค่าชนิดใด

@mcp.tool()
def greet(name: str) -> str:
    return "Hello, " + name

เอกสารสตริงกลายเป็นคำอธิบาย

เอกสารสตริงของฟังก์ชันจะกลายเป็นคำอธิบายของเครื่องมือ โมเดลจะอ่านคำอธิบายนี้เพื่อตัดสินใจว่าเมื่อใดควรใช้เครื่องมือนี้

@mcp.tool()
def greet(name: str) -> str:
    """Greet a person by name."""
    return "Hello, " + name

ชื่อมาจากฟังก์ชัน

โดยค่าเริ่มต้น ชื่อของเครื่องมือจะเป็นชื่อฟังก์ชัน ดังนั้น def greet จะเผยแพร่เครื่องมือที่ไคลเอ็นต์แสดงชื่อว่า "greet"

ส่งคืนข้อความธรรมดา

สำหรับเครื่องมือแรก เพียงส่งคืนสตริง FastMCP จะห่อสตริงนั้นให้อยู่ในรูปแบบผลลัพธ์ MCP ที่ถูกต้อง เพื่อให้ไคลเอ็นต์ได้รับข้อความที่สะอาดและพร้อมใช้

อธิบายให้ดี

การใช้ถ้อยคำที่ดีมีความสำคัญ: คำอธิบายที่ชัดเจนช่วยให้โมเดลเลือกเครื่องมือของคุณได้ถูกจังหวะ เอกสารสตริงที่คลุมเครือทำให้เกิดการเรียกใช้ที่พลาดได้

ระบบลงทะเบียนให้อัตโนมัติ

คุณไม่ต้องเรียกฟังก์ชันลงทะเบียนด้วยตนเอง เพียงใส่มัณฑนากร เครื่องมือก็จะถูกลงทะเบียนไว้ในอินสแตนซ์ mcp และพร้อมประกาศให้ทราบ

เพิ่มได้ตามต้องการ

หนึ่งเซิร์ฟเวอร์สามารถมีเครื่องมือได้หลายรายการ เพียงใส่มัณฑนากรให้แต่ละฟังก์ชัน แล้วเครื่องมือทั้งหมดจะแสดงพร้อมกันเมื่อไคลเอ็นต์ถามว่ามีอะไรให้ใช้งานบ้าง

ตรวจสอบอย่างรวดเร็ว

คำอธิบายของเครื่องมือมาจากที่ใด

สรุป

คุณเพิ่มเครื่องมือด้วย @mcp.tool() กำหนดพารามิเตอร์พร้อมชนิดข้อมูล และใช้เอกสารสตริงอธิบายเครื่องมือ ตอนนี้เซิร์ฟเวอร์ของคุณทำงานบางอย่างได้แล้ว มาเริ่มใช้งานกัน! ✨

เริ่มต้นได้ฟรี

เรียนรู้ Python ด้วย AI tutor — ฟรี

เขียนและเรียกใช้โค้ดจริงในเบราว์เซอร์ของคุณ รับความช่วยเหลือทันทีจาก AI tutor 24/7 และเรียนรู้ต่อจากที่คุณหยุดบนเว็บหรือในแอป

คอร์ส
30
บทเรียน
120

คำถามที่พบบ่อย

บทเรียน “เพิ่มเครื่องมือทักทาย” ฟรีหรือไม่

ใช่ — ข้อความเต็มของ “เพิ่มเครื่องมือทักทาย” ฟรีให้อ่านที่นี่บนเว็บ เพื่อปฏิบัติแบบโต้ตอบ (ตัวแก้ไขโค้ดในตัวและติวเตอร์ AI ตลอด 24/7) และปลดล็อคส่วนที่เหลือของคอร์ส MCP Academy ให้อัปเกรดเป็น CoddyKit PRO คอร์ส MCP Academy มีบทเรียนทั้งหมด 4 บทเรียน

คุณจะเรียนรู้อะไรในบทเรียน “เพิ่มเครื่องมือทักทาย”

ตกแต่งฟังก์ชัน Python เพื่อให้ปัญญาประดิษฐ์เรียกใช้ได้ คุณปฏิบัติ MCP Academy ด้วยโค้ดที่ใช้งานได้จริงที่คุณเรียกใช้โดยตรงในเบราว์เซอร์ และติวเตอร์ AI ตลอด 24/7 ตอบคำถามของคุณขณะที่คุณไปผ่านบทเรียน

คุณต้องมีประสบการณ์ก่อนที่จะเริ่มเรียน MCP Academy หรือไม่

ไม่จำเป็นต้องมีประสบการณ์มาก่อน MCP Academy บน CoddyKit ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 2 จากทั้งหมด 4 บทเรียน

บทเรียน “เพิ่มเครื่องมือทักทาย” ใช้เวลานานแค่ไหน

บทเรียน CoddyKit ส่วนใหญ่ใช้เวลาประมาณ 5–10 นาที แต่ละบทเรียนจึงสั้นและเป็นแบบโต้ตอบ คุณสามารถก้าวหน้าอย่างต่อเนื่องและกลับมาเรียนต่อจากตรงที่เพิ่งหยุดบนเว็บและแอปได้เลย

ฉันเขียนและรันโค้ดในบทเรียน MCP Academy นี้ได้ไหม

ได้ บทเรียน MCP Academy ทุกบทมีตัวแก้ไขโค้ดในตัว คุณจึงเขียนและรันโค้ดจริงได้เลยในเบราว์เซอร์ และได้รับข้อเสนอแนะจาก AI ในทันที — ไม่ต้องติดตั้งในเครื่องของคุณ

บทเรียนทั้งหมดในหลักสูตรนี้

  1. สร้างอินสแตนซ์ FastMCP
  2. เพิ่มเครื่องมือทักทาย
  3. เรียกใช้เซิร์ฟเวอร์ด้วย stdio
  4. ยืนยันว่าโหลดและแสดงรายการเครื่องมือได้
← กลับไปที่ MCP Academy