MCP Academy · บทเรียน

เครื่องมือเครื่องคิดเลขตั้งแต่ต้นจนจบ

สร้างเครื่องมือคำนวณเลขคณิตขนาดเล็กแต่ครบถ้วน

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

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

สร้างเครื่องมือให้สมบูรณ์หนึ่งรายการ

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

เริ่มจากเซิร์ฟเวอร์

ขั้นแรก ให้สร้างอินสแตนซ์ FastMCP เพื่อเก็บเครื่องมือ ตั้งชื่อให้กับอินสแตนซ์เพื่อให้ไคลเอนต์ระบุเซิร์ฟเวอร์ของคุณได้

from mcp.server.fastmcp import FastMCP
mcp = FastMCP("calculator")

ตั้งชื่อการดำเนินการ

เลือกชื่อที่เจาะจง เราจะบวกตัวเลขสองจำนวน ดังนั้นฟังก์ชัน add จึงสื่อความหมายได้ชัดเจนทั้งสำหรับคุณและโมเดล

ประกาศพารามิเตอร์ที่มีชนิดข้อมูล

ใช้คำใบ้ชนิดข้อมูลเพื่อให้โมเดลส่งตัวเลข ไม่ใช่ข้อความ เรารับค่า float สองค่าเพื่อรองรับทั้งทศนิยมและจำนวนเต็ม

def add(a: float, b: float) -> float:
    ...

เขียน Docstring

Docstringจะกลายเป็นคำอธิบาย ดังนั้นให้ระบุอย่างชัดเจนว่าเครื่องมือทำอะไรและส่งคืนอะไร

def add(a: float, b: float) -> float:
    """Add two numbers and return the sum."""

ตกแต่งให้เป็นเครื่องมือ

เพิ่มตัวตกแต่งเครื่องมือเพื่อให้ FastMCP ลงทะเบียนฟังก์ชันและประกาศฟังก์ชันนี้แก่ไคลเอนต์ที่เชื่อมต่ออยู่

@mcp.tool()
def add(a: float, b: float) -> float:
    """Add two numbers."""
    return a + b

ส่งคืนผลลัพธ์ที่ชัดเจน

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

    return a + b

เพิ่มเครื่องมือที่สอง

หนึ่งเครื่องมือต่อหนึ่งหน้าที่ ดังนั้นให้สร้างเครื่องมือ divide แยกต่างหาก แทนการรวมหลายโหมดไว้ใน add แต่ละเครื่องมือจะยังเรียกใช้ได้ง่าย

@mcp.tool()
def divide(a: float, b: float) -> float:
    return a / b

ป้องกันข้อมูลนำเข้าที่ไม่ถูกต้อง

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

    if b == 0:
        return "Error: cannot divide by zero."

เรียกใช้เซิร์ฟเวอร์

ปิดท้ายด้วยการเรียก run เพื่อให้เซิร์ฟเวอร์เริ่มทำงานและรอรับการเชื่อมต่อจากลูกข่ายผ่าน stdio เมื่อคุณเปิดใช้ไฟล์

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

ทดสอบเครื่องมือทั้งหมด

เปิดใช้งาน แล้วให้ลูกข่ายแสดงรายการเครื่องมือของคุณ การเห็น add และ divide พร้อมคำอธิบายยืนยันว่าการเชื่อมต่อทำงานถูกต้อง

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

เหตุใดจึงควรให้ divide มีเครื่องมือของตัวเอง แทนที่จะใช้แฟล็กโหมดกับ add

สรุปทบทวน

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

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

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

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

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

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

บทเรียน “เครื่องมือเครื่องคิดเลขตั้งแต่ต้นจนจบ” ฟรีหรือไม่

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

คุณจะเรียนรู้อะไรในบทเรียน “เครื่องมือเครื่องคิดเลขตั้งแต่ต้นจนจบ”

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

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

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

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

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

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

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

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

  1. ตั้งชื่อและอธิบายเครื่องมือให้ดี
  2. ประกาศพารามิเตอร์ด้วยคำใบ้ชนิดข้อมูล
  3. ส่งคืนผลลัพธ์ที่มีประโยชน์
  4. เครื่องมือเครื่องคิดเลขตั้งแต่ต้นจนจบ
← กลับไปที่ MCP Academy