MCP Academy · บทเรียน

กำหนดขอบเขตโครงการและเครื่องมือ

ตัดสินใจว่าเซิร์ฟเวอร์จะเปิดเผยความสามารถใดบ้าง

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

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

ได้เวลาส่งมอบสิ่งที่ใช้งานได้จริง

คุณได้เรียนรู้ส่วนประกอบต่าง ๆ แล้ว ตอนนี้ถึงเวลาสร้างเซิร์ฟเวอร์ที่สมบูรณ์ บทเรียนสรุปนี้จะรวมบริการจริงหนึ่งรายการให้เป็นเซิร์ฟเวอร์ MCP ที่เป็นระเบียบและติดตั้งได้ 🚀

เริ่มจากเป้าหมายของผู้ใช้

ก่อนเขียนโค้ด ให้ระบุ งานที่เซิร์ฟเวอร์ของคุณช่วยจัดการ เป้าหมายที่ชัดเจน เช่น การค้นหาบันทึกของฉัน จะช่วยให้การตัดสินใจในภายหลังมีทิศทางและไม่ซับซ้อน

เลือกบริการจริงเพียงหนึ่งรายการ

เลือก แบ็กเอนด์ ที่เป็นรูปธรรมเพียงหนึ่งรายการ เช่น โฟลเดอร์บันทึก ฐานข้อมูล SQLite หรือ API สาธารณะหนึ่งรายการ แหล่งข้อมูลเดียวทำให้บทสรุปโครงการพร้อมส่งมอบและไม่บานปลาย

ลิสต์ความสามารถ

จดสิ่งที่ AI ควรทำได้ เช่น ค้นหา อ่าน และเพิ่ม รายการ ความสามารถสั้น ๆ นี้จะกลายเป็นแผนผังของเครื่องมือและ resource ของคุณ

แยกการดำเนินการออกจากการอ่าน

แบ่งรายการของคุณออกเป็นสองส่วน สิ่งที่เปลี่ยนสถานะคือ เครื่องมือ ส่วนสิ่งที่ดึงเฉพาะบริบทคือ resource การจัดหมวดหมู่นี้จะกำหนด primitive แต่ละรายการไว้ตั้งแต่ต้น

ร่างลายเซ็นของ tool

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

# add_note(title: str, body: str) -> str
# search_notes(query: str) -> list[str]
# A two-line sketch is enough to start.

วางแผน resource หนึ่งรายการ

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

วางแผน prompt หนึ่งรายการ

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

กำหนดความสำเร็จตั้งแต่เนิ่น ๆ

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

ตั้งชื่อเซิร์ฟเวอร์

ตั้ง ชื่อโครงการให้สั้นและสื่อความหมาย เช่น notes-mcp ไคลเอ็นต์จะแสดงชื่อนี้แก่ผู้ใช้ จึงควรทำให้ผู้ใช้เข้าใจได้ทันทีว่าเซิร์ฟเวอร์ทำอะไร

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("notes-mcp")

เขียนข้อกำหนดสั้น ๆ

บันทึกแผนไว้ในไฟล์ ข้อกำหนดสั้น ๆ หนึ่งไฟล์ โดยระบุเป้าหมาย แบ็กเอนด์ เครื่องมือ resource และ prompt หน้านี้จะเป็นรายการตรวจสอบขณะคุณสร้างส่วนที่เหลือ

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

มาทบทวนวิธีจัดหมวดหมู่ความสามารถของคุณกัน

ทบทวน

คุณกำหนดขอบเขตโครงการจริงแล้ว ได้แก่ เป้าหมายหนึ่งรายการ แบ็กเอนด์หนึ่งรายการ และรายการเครื่องมือ resource กับ prompt ที่กระชับ แผนที่ชัดเจนทำให้สร้างได้ง่าย 🎯

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

เรียนรู้ 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 ออกแบบมาสำหรับผู้เริ่มต้นไปจนถึงผู้เรียนขั้นสูง คุณสามารถเริ่มต้นที่นี่หรือเริ่มจากตัวแรกและเรียนด้วยความเร็วของคุณเอง นี่คือบทเรียนที่ 1 จากทั้งหมด 4 บทเรียน

บทเรียน “กำหนดขอบเขตโครงการและเครื่องมือ” ใช้เวลานานแค่ไหน

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

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

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

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

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