Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 12.8 KB

README.md

File metadata and controls

161 lines (108 loc) · 12.8 KB

การทดสอบและแก้ไขข้อผิดพลาด

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

ภาพรวม

บทเรียนนี้ครอบคลุมวิธีการเลือกแนวทางการทดสอบที่เหมาะสมและเครื่องมือทดสอบที่มีประสิทธิภาพที่สุด

วัตถุประสงค์การเรียนรู้

เมื่อจบบทเรียนนี้ คุณจะสามารถ:

  • อธิบายแนวทางต่าง ๆ สำหรับการทดสอบ
  • ใช้เครื่องมือต่าง ๆ เพื่อทดสอบโค้ดของคุณอย่างมีประสิทธิภาพ

การทดสอบ MCP Servers

MCP มีเครื่องมือช่วยให้คุณทดสอบและแก้ไขข้อผิดพลาดของเซิร์ฟเวอร์ได้:

  • MCP Inspector: เครื่องมือบรรทัดคำสั่งที่สามารถใช้งานได้ทั้งในรูปแบบ CLI และเครื่องมือแบบภาพ
  • การทดสอบด้วยตนเอง: คุณสามารถใช้เครื่องมืออย่าง curl เพื่อส่งคำขอเว็บ แต่เครื่องมือใดที่สามารถรัน HTTP ก็ใช้ได้
  • การทดสอบหน่วย: คุณสามารถใช้กรอบการทดสอบที่คุณชื่นชอบเพื่อทดสอบฟีเจอร์ทั้งของเซิร์ฟเวอร์และไคลเอนต์

การใช้ MCP Inspector

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

MCP Inspector ช่วยให้คุณ:

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

การรันเครื่องมือทั่วไปจะมีลักษณะดังนี้:

npx @modelcontextprotocol/inspector node build/index.js

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

นี่คือตัวอย่างหน้าตาของมัน: Inspector

คุณยังสามารถรันเครื่องมือนี้ในโหมด CLI โดยเพิ่มอาร์กิวเมนต์ --cli ตัวอย่างนี้แสดงการรันเครื่องมือในโหมด "CLI" ซึ่งจะแสดงรายการเครื่องมือทั้งหมดบนเซิร์ฟเวอร์:

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

การทดสอบด้วยตนเอง

นอกจากการรันเครื่องมือ inspector เพื่อทดสอบความสามารถของเซิร์ฟเวอร์แล้ว อีกวิธีที่คล้ายกันคือการรันไคลเอนต์ที่สามารถใช้ HTTP ได้ เช่น curl

ด้วย curl คุณสามารถทดสอบ MCP servers โดยตรงผ่านคำขอ HTTP ได้:

# Example: Test server metadata
curl http://localhost:3000/v1/metadata

# Example: Execute a tool
curl -X POST http://localhost:3000/v1/tools/execute \
  -H "Content-Type: application/json" \
  -d '{"name": "calculator", "parameters": {"expression": "2+2"}}'

จากตัวอย่างการใช้ curl ข้างต้น คุณใช้คำขอ POST เพื่อเรียกใช้งานเครื่องมือโดยส่งเพย์โหลดที่ประกอบด้วยชื่อเครื่องมือและพารามิเตอร์ของมัน ใช้วิธีที่เหมาะสมกับคุณที่สุด เครื่องมือ CLI มักจะใช้งานได้รวดเร็วและสามารถเขียนสคริปต์ได้ ซึ่งมีประโยชน์ในสภาพแวดล้อม CI/CD

การทดสอบหน่วย

สร้างการทดสอบหน่วยสำหรับเครื่องมือและทรัพยากรของคุณเพื่อให้แน่ใจว่าทำงานตามที่คาดหวัง นี่คือตัวอย่างโค้ดทดสอบ

import pytest

from mcp.server.fastmcp import FastMCP
from mcp.shared.memory import (
    create_connected_server_and_client_session as create_session,
)

# Mark the whole module for async tests
pytestmark = pytest.mark.anyio


async def test_list_tools_cursor_parameter():
    """Test that the cursor parameter is accepted for list_tools.

    Note: FastMCP doesn't currently implement pagination, so this test
    only verifies that the cursor parameter is accepted by the client.
    """

 server = FastMCP("test")

    # Create a couple of test tools
    @server.tool(name="test_tool_1")
    async def test_tool_1() -> str:
        """First test tool"""
        return "Result 1"

    @server.tool(name="test_tool_2")
    async def test_tool_2() -> str:
        """Second test tool"""
        return "Result 2"

    async with create_session(server._mcp_server) as client_session:
        # Test without cursor parameter (omitted)
        result1 = await client_session.list_tools()
        assert len(result1.tools) == 2

        # Test with cursor=None
        result2 = await client_session.list_tools(cursor=None)
        assert len(result2.tools) == 2

        # Test with cursor as string
        result3 = await client_session.list_tools(cursor="some_cursor_value")
        assert len(result3.tools) == 2

        # Test with empty string cursor
        result4 = await client_session.list_tools(cursor="")
        assert len(result4.tools) == 2

โค้ดด้านบนทำสิ่งต่อไปนี้:

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

ดูไฟล์ฉบับเต็มได้ที่ full file here

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

SDK หลัก ๆ ทั้งหมดมีส่วนทดสอบที่คล้ายกัน ดังนั้นคุณสามารถปรับให้เหมาะกับ runtime ที่คุณเลือกได้

ตัวอย่าง

แหล่งข้อมูลเพิ่มเติม

ต่อไปคือ

ข้อจำกัดความรับผิดชอบ:
เอกสารนี้ได้รับการแปลโดยใช้บริการแปลภาษาอัตโนมัติ Co-op Translator แม้เราจะพยายามให้มีความถูกต้องสูงสุด แต่โปรดทราบว่าการแปลโดยอัตโนมัติอาจมีข้อผิดพลาดหรือความคลาดเคลื่อนได้ เอกสารต้นฉบับในภาษาต้นทางควรถูกพิจารณาเป็นแหล่งข้อมูลที่เชื่อถือได้ สำหรับข้อมูลที่สำคัญ ควรใช้บริการแปลโดยผู้เชี่ยวชาญมืออาชีพ เราจะไม่รับผิดชอบต่อความเข้าใจผิดหรือการตีความที่ผิดพลาดที่เกิดจากการใช้การแปลนี้