Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 7.15 KB

README.md

File metadata and controls

161 lines (108 loc) · 7.15 KB

Testiranje i otklanjanje pogrešaka

Prije nego što započnete s testiranjem vašeg MCP servera, važno je razumjeti dostupne alate i najbolje prakse za otklanjanje pogrešaka. Učinkovito testiranje osigurava da vaš server radi kako se očekuje i pomaže vam brzo identificirati i riješiti probleme. Sljedeći odjeljak opisuje preporučene pristupe za provjeru vaše MCP implementacije.

Pregled

Ova lekcija objašnjava kako odabrati pravi pristup testiranju i najučinkovitiji alat za testiranje.

Ciljevi učenja

Na kraju ove lekcije moći ćete:

  • Opisati različite pristupe testiranju.
  • Koristiti različite alate za učinkovito testiranje vašeg koda.

Testiranje MCP servera

MCP pruža alate koji vam pomažu u testiranju i otklanjanju pogrešaka vaših servera:

  • MCP Inspector: Alat za naredbeni redak koji se može koristiti i kao CLI alat i kao vizualni alat.
  • Ručno testiranje: Možete koristiti alat poput curl za izvođenje web zahtjeva, ali bilo koji alat sposoban za HTTP će poslužiti.
  • Jedinično testiranje: Moguće je koristiti vaš omiljeni testni okvir za testiranje značajki i servera i klijenta.

Korištenje MCP Inspectora

Opisali smo korištenje ovog alata u prethodnim lekcijama, ali hajdemo ga ukratko predstaviti. To je alat izgrađen u Node.js-u i možete ga koristiti pozivom npx izvršne datoteke koja će privremeno preuzeti i instalirati alat, a zatim se sama očistiti nakon što završi s vašim zahtjevom.

MCP Inspector vam pomaže:

  • Otkrivanje mogućnosti servera: Automatski detektira dostupne resurse, alate i upite
  • Testiranje izvršavanja alata: Isprobajte različite parametre i pratite odgovore u stvarnom vremenu
  • Pregled metapodataka servera: Istražite informacije o serveru, sheme i konfiguracije

Tipično pokretanje alata izgleda ovako:

npx @modelcontextprotocol/inspector node build/index.js

Gornja naredba pokreće MCP i njegov vizualni sučelje te otvara lokalno web sučelje u vašem pregledniku. Možete očekivati nadzornu ploču koja prikazuje vaše registrirane MCP servere, njihove dostupne alate, resurse i upite. Sučelje vam omogućuje interaktivno testiranje izvršavanja alata, pregled metapodataka servera i praćenje odgovora u stvarnom vremenu, što olakšava provjeru i otklanjanje pogrešaka u implementacijama MCP servera.

Evo kako to može izgledati: Inspector

Također možete pokrenuti ovaj alat u CLI načinu rada dodavanjem atributa --cli. Evo primjera pokretanja alata u "CLI" načinu koji prikazuje sve alate na serveru:

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

Ručno testiranje

Osim pokretanja inspectora za testiranje mogućnosti servera, sličan pristup je korištenje klijenta sposoban za HTTP, poput curl.

Pomoću curl-a možete izravno testirati MCP servere koristeći HTTP zahtjeve:

# 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"}}'

Kao što vidite iz primjera korištenja curl-a, koristite POST zahtjev za pozivanje alata s payloadom koji sadrži ime alata i njegove parametre. Koristite pristup koji vam najviše odgovara. CLI alati su općenito brži za korištenje i pogodni za skriptiranje, što može biti korisno u CI/CD okruženju.

Jedinično testiranje

Izradite jedinične testove za vaše alate i resurse kako biste osigurali da rade kako se očekuje. Evo primjera testnog koda.

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

Gornji kod radi sljedeće:

  • Koristi pytest okvir koji vam omogućuje kreiranje testova kao funkcija i korištenje assert naredbi.
  • Kreira MCP Server s dva različita alata.
  • Koristi assert naredbu za provjeru ispunjenosti određenih uvjeta.

Pogledajte cijelu datoteku ovdje

Na temelju ove datoteke možete testirati vlastiti server kako biste osigurali da su mogućnosti kreirane kako treba.

Svi glavni SDK-ovi imaju slične odjeljke za testiranje pa ih možete prilagoditi vašem odabranom runtime okruženju.

Primjeri

Dodatni resursi

Što slijedi

Odricanje od odgovornosti:
Ovaj dokument je preveden korištenjem AI usluge za prevođenje Co-op Translator. Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazuma ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda.