Skip to content

complete_examples.md

Latest commit

 

History

History
162 lines (120 loc) · 5.52 KB

complete_examples.md

File metadata and controls

162 lines (120 loc) · 5.52 KB

Kompletta MCP-klientexempel

Den här katalogen innehåller kompletta, fungerande exempel på MCP-klienter i olika programmeringsspråk. Varje klient demonstrerar den fullständiga funktionaliteten som beskrivs i huvudhandledningen README.md.

Tillgängliga klienter

1. Java-klient (client_example_java.java)

  • Transport: SSE (Server-Sent Events) över HTTP
  • Målsystem: http://localhost:8080
  • Funktioner:
    • Upprätta anslutning och ping
    • Verktygslistning
    • Kalkylatoroperationer (addera, subtrahera, multiplicera, dividera, hjälp)
    • Felhantering och resultatutvinning

För att köra:

# Ensure your MCP server is running on localhost:8080
javac client_example_java.java
java client_example_java

2. C#-klient (client_example_csharp.cs)

  • Transport: Stdio (Standard Input/Output)
  • Målsystem: Lokal .NET MCP-server via dotnet run
  • Funktioner:
    • Automatisk serverstart via stdio-transport
    • Verktygs- och resurslistning
    • Kalkylatoroperationer
    • JSON-resultatparsing
    • Omfattande felhantering

För att köra:

dotnet run

3. TypeScript-klient (client_example_typescript.ts)

  • Transport: Stdio (Standard Input/Output)
  • Målsystem: Lokal Node.js MCP-server
  • Funktioner:
    • Fullt stöd för MCP-protokoll
    • Verktygs-, resurs- och promptoperationer
    • Kalkylatoroperationer
    • Resursläsning och promptkörning
    • Robust felhantering

För att köra:

# First compile TypeScript (if needed)
npm run build

# Then run the client
npm run client
# or
node client_example_typescript.js

4. Python-klient (client_example_python.py)

  • Transport: Stdio (Standard Input/Output)
  • Målsystem: Lokal Python MCP-server
  • Funktioner:
    • Async/await-mönster för operationer
    • Upptäckt av verktyg och resurser
    • Testning av kalkylatoroperationer
    • Läsning av resursinnehåll
    • Klassbaserad organisation

För att köra:

python client_example_python.py

Gemensamma funktioner för alla klienter

Varje klientimplementering demonstrerar:

  1. Anslutningshantering

    • Upprätta anslutning till MCP-servern
    • Hantera anslutningsfel
    • Rätt städning och resursförvaltning

  2. Serverupptäckt

    • Lista tillgängliga verktyg
    • Lista tillgängliga resurser (där det stöds)
    • Lista tillgängliga prompts (där det stöds)

  3. Verktygsanrop

    • Grundläggande kalkylatoroperationer (addera, subtrahera, multiplicera, dividera)
    • Hjälpkommando för serverinformation
    • Korrekt argumentöverföring och resultatbehandling

  4. Felhantering

    • Anslutningsfel
    • Fel vid verktygskörning
    • Smidig hantering av fel och användarfeedback

  5. Resultatbehandling

    • Extrahera textinnehåll från svar
    • Formatera utdata för läsbarhet
    • Hantera olika svarformat

Förutsättningar

Innan du kör dessa klienter, se till att du har:

  1. Den motsvarande MCP-servern igång (från ../01-first-server/)
  2. Nödvändiga beroenden installerade för ditt valda språk
  3. Korrekt nätverksanslutning (för HTTP-baserade transporter)

Viktiga skillnader mellan implementeringar

Språk Transport Serverstart Async-modell Nyckelbibliotek
Java SSE/HTTP Extern Synkron WebFlux, MCP SDK
C# Stdio Automatisk Async/Await .NET MCP SDK
TypeScript Stdio Automatisk Async/Await Node MCP SDK
Python Stdio Automatisk AsyncIO Python MCP SDK
Rust Stdio Automatisk Async/Await Rust MCP SDK, Tokio

Nästa steg

Efter att ha utforskat dessa klientexempel:

  1. Modifiera klienterna för att lägga till nya funktioner eller operationer
  2. Skapa din egen server och testa den med dessa klienter
  3. Experimentera med olika transporter (SSE vs. Stdio)
  4. Bygg en mer komplex applikation som integrerar MCP-funktionalitet

Felsökning

Vanliga problem

  1. Anslutning nekad: Kontrollera att MCP-servern körs på den förväntade porten/sökvägen
  2. Modul saknas: Installera det nödvändiga MCP SDK för ditt språk
  3. Åtkomst nekad: Kontrollera filbehörigheter för stdio-transport
  4. Verktyg saknas: Verifiera att servern implementerar de förväntade verktygen

Debug-tips

  1. Aktivera detaljerad loggning i ditt MCP SDK
  2. Kontrollera serverloggar för felmeddelanden
  3. Verifiera verktygsnamn och signaturer matchar mellan klient och server
  4. Testa med MCP Inspector först för att validera serverfunktionalitet

Relaterad dokumentation

Ansvarsfriskrivning:
Detta dokument har översatts med hjälp av AI-översättningstjänsten Co-op Translator. Även om vi strävar efter noggrannhet, vänligen notera att automatiserade översättningar kan innehålla fel eller inexaktheter. Det ursprungliga dokumentet på dess originalspråk bör betraktas som den auktoritativa källan. För kritisk information rekommenderas professionell mänsklig översättning. Vi ansvarar inte för eventuella missförstånd eller feltolkningar som uppstår vid användning av denna översättning.