Skip to content

Latest commit

 

History

History
161 lines (108 loc) · 7.33 KB

README.md

File metadata and controls

161 lines (108 loc) · 7.33 KB

Testaus ja virheenkorjaus

Ennen kuin aloitat MCP-palvelimesi testaamisen, on tärkeää ymmärtää käytettävissä olevat työkalut ja parhaat käytännöt virheiden etsimiseen. Tehokas testaus varmistaa, että palvelimesi toimii odotetusti ja auttaa sinua nopeasti tunnistamaan ja korjaamaan ongelmat. Seuraavassa osiossa käydään läpi suositeltuja menetelmiä MCP-toteutuksesi validoimiseksi.

Yleiskatsaus

Tässä oppitunnissa käsitellään, miten valita oikea testausmenetelmä ja tehokkain testausväline.

Oppimistavoitteet

Oppitunnin lopussa osaat:

  • Kuvailla erilaisia testausmenetelmiä.
  • Käyttää eri työkaluja koodisi tehokkaaseen testaamiseen.

MCP-palvelinten testaus

MCP tarjoaa työkaluja palvelimiesi testaamiseen ja virheenkorjaukseen:

  • MCP Inspector: Komentorivityökalu, jota voi käyttää sekä CLI- että visuaalisena työkaluna.
  • Manuaalinen testaus: Voit käyttää esimerkiksi curl-työkalua web-pyyntöjen tekemiseen, mutta mikä tahansa HTTP-pyyntöjä tukeva työkalu käy.
  • Yksikkötestaus: Voit käyttää suosikkitestikehystäsi testataksesi sekä palvelimen että asiakkaan ominaisuuksia.

MCP Inspectorin käyttö

Olemme kuvanneet tämän työkalun käyttöä aiemmissa oppitunneissa, mutta käydään se nyt lyhyesti läpi. Työkalu on rakennettu Node.js:llä, ja sitä voi käyttää kutsumalla npx-suoritustiedostoa, joka lataa ja asentaa työkalun väliaikaisesti ja poistaa sen käytön jälkeen.

MCP Inspector auttaa sinua:

  • Palvelimen ominaisuuksien löytämisessä: Havaitsee automaattisesti käytettävissä olevat resurssit, työkalut ja kehotteet
  • Työkalujen suorittamisen testaamisessa: Kokeile eri parametreja ja näe vastaukset reaaliajassa
  • Palvelimen metatietojen tarkastelussa: Tutki palvelimen tietoja, skeemoja ja asetuksia

Tyypillinen työkalun käynnistys näyttää tältä:

npx @modelcontextprotocol/inspector node build/index.js

Yllä oleva komento käynnistää MCP:n ja sen visuaalisen käyttöliittymän sekä avaa paikallisen web-käyttöliittymän selaimessasi. Näet kojelaudan, jossa on rekisteröidyt MCP-palvelimesi, niiden käytettävissä olevat työkalut, resurssit ja kehotteet. Käyttöliittymä mahdollistaa työkalujen suorittamisen interaktiivisen testauksen, palvelimen metatietojen tarkastelun ja reaaliaikaisten vastausten seuraamisen, mikä helpottaa MCP-palvelintoteutustesi validointia ja virheenkorjausta.

Tältä se voi näyttää: Inspector

Voit myös käyttää työkalua CLI-tilassa lisäämällä --cli-attribuutin. Tässä esimerkki työkalun ajamisesta "CLI"-tilassa, joka listaa kaikki palvelimen työkalut:

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

Manuaalinen testaus

Inspector-työkalun lisäksi voit testata palvelimen ominaisuuksia käyttämällä HTTP-pyyntöjä tukevaa asiakasohjelmaa, kuten curlia.

Curlilla voit testata MCP-palvelimia suoraan HTTP-pyyntöjen avulla:

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

Kuten yllä olevasta curl-esimerkistä näkyy, käytät POST-pyyntöä kutsuaksesi työkalua, jonka kuormana on työkalun nimi ja sen parametrit. Valitse sinulle parhaiten sopiva tapa. Komentorivityökalut ovat yleensä nopeampia käyttää ja ne soveltuvat hyvin skriptattaviksi, mikä on hyödyllistä CI/CD-ympäristössä.

Yksikkötestaus

Luo yksikkötestejä työkaluillesi ja resursseillesi varmistaaksesi, että ne toimivat odotetusti. Tässä esimerkki testauskoodista.

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

Edellä oleva koodi tekee seuraavaa:

  • Hyödyntää pytest-kehystä, jonka avulla voit luoda testejä funktioina ja käyttää assert-lauseita.
  • Luo MCP-palvelimen, jossa on kaksi eri työkalua.
  • Käyttää assert-lausetta tarkistaakseen, että tietyt ehdot täyttyvät.

Tutustu kokonaisiin tiedostoihin täällä

Tämän tiedoston avulla voit testata omaa palvelintasi varmistaaksesi, että ominaisuudet luodaan oikein.

Kaikissa suurissa SDK:issa on vastaavat testausosiot, joten voit mukautua valitsemaasi ajonaikaiseen ympäristöön.

Esimerkit

Lisäresurssit

Mitä seuraavaksi

Vastuuvapauslauseke:
Tämä asiakirja on käännetty käyttämällä tekoälypohjaista käännöspalvelua Co-op Translator. Vaikka pyrimme tarkkuuteen, huomioithan, että automaattikäännöksissä saattaa esiintyä virheitä tai epätarkkuuksia. Alkuperäistä asiakirjaa sen alkuperäiskielellä tulee pitää virallisena lähteenä. Tärkeissä asioissa suositellaan ammattimaista ihmiskäännöstä. Emme ole vastuussa tämän käännöksen käytöstä aiheutuvista väärinymmärryksistä tai tulkinnoista.