Przejdź do głównej treści
Polski— Wybierz język
Menu

Demo: Łączenie Pokémon Showdown przez MCP

Lekcja 12 z 14 Zaktualizowano 2 listopada 2026 Średnio zaawansowani
Na tej stronie
  1. Nauka przez zabawę
  2. Koncepcja
  3. Architektura serwera MCP
  4. Wzorzec prowadzenia przez odpowiedź
  5. Zasady stosowane w Twoich projektach
  6. Ograniczenia czasu rzeczywistego
  7. Kluczowe wnioski

Aktualizacja z 2 listopada 2026 r. — Le Chat to teraz Vibe. Od 28 maja 2026 r. Le Chat zmienił nazwę na Vibe (nadal pod adresem chat.mistral.ai): to pojedynczy agent do pracy i kodowania, który zachowuje Twoje konwersacje, ustawienia i subskrypcje. Legacyjne doświadczenie Le Chat pozostaje dostępne w trybie Chat; w trybie Work agenci stali się umiejętnościami (wywoływanymi za pomocą @), pamięci służą jako baza wiedzy, a głębokie wyszukiwanie to teraz umiejętność Deep Research. Plany noszą teraz nazwy Mistral Free, Pro, Team i Enterprise. W tej lekcji używamy nazwy Vibe; pamiętaj, że niektóre opisane tu menu mogły zmienić nazwy lub lokalizację.

Nauka przez zabawę

Aby konkretnie zilustrować tworzenie i używanie niestandardowego konektora MCP, zajmiemy się zabawnym, ale pouczającym przypadkiem: podłączeniem Pokémon Showdown, słynnego internetowego symulatora walk Pokémon, do Vibe przez MCP. To studium przypadku, zaprezentowane przez zespół Mistral AI podczas sesji na żywo, wdraża zasady bezpośrednio przenoszalne na dowolną integrację zawodową. Temat jest lekki, ale wnioski techniczne – jak najbardziej poważne.

Koncepcja

Pokémon Showdown to platforma internetowa, na której gracze stają do strategicznych, turowych walk. Celem serwera MCP jest umożliwienie Vibe połączenia się z platformą jako gracz, wyzwania przeciwnika, analizy stanu bitwy (aktywne Pokémony, punkty życia HP, dostępne ruchy) oraz wyboru najlepszego działania w każdej turze. Ćwiczenie to jest cenne, ponieważ koncentruje cztery wyzwania, rzadko występujące razem: komunikację w czasie rzeczywistym, zarządzanie stanem, sekwencyjne podejmowanie decyzji oraz prowadzenie modelu poprzez odpowiedzi narzędzi.

Architektura serwera MCP

Serwer udostępnia najpierw narzędzie battle_player, które inicjuje walkę. Przyjmuje ono nazwę użytkownika jako parametr i zwraca unikalny ID bitwy, początkowy stan bitwy (Pokémony każdej drużyny, HP itp.) oraz instrukcje dla modelu dotyczące tego, których narzędzi użyć dalej. Ten trzeci element jest daleki od trywialnego: osadzanie instrukcji przepływu pracy w wartościach zwracanych przez narzędzia to zaawansowany wzorzec projektowania MCP, do którego wrócimy poniżej.

Kolejne jest narzędzie do akcji bitewnych. W każdej turze Vibe musi wybrać między atakiem, zmianą Pokémona a użyciem przedmiotu. Narzędzie otrzymuje ID bitwy, typ akcji oraz ID ruchu lub Pokémona do wystawienia, a następnie zwraca nowy stan bitwy po wykonaniu akcji. Cykl powtarza się aż do końca gry, przy czym każda odpowiedź służy jako punkt wyjścia do następnej decyzji.

Wzorzec prowadzenia przez odpowiedź

Najważniejszą lekcją z tego demo jest prowadzenie modelu poprzez wartości zwracane. Zamiast polegać wyłącznie na monicie użytkownika do kierowania przepływem pracy, serwer MCP przemyca instrukcje w swoich odpowiedziach:

Result: Battle started. Your active Pokémon is Pikachu (HP: 100%).
The opponent sent out Charizard.

→ Use the 'choose_move' tool to select an attack,
  or 'switch_pokemon' to change Pokémon.
  Available moves: Thunderbolt, Surf, Quick Attack, Protect.

Model nie musi już zgadywać następnego kroku: otrzymuje wyraźną informację, wraz z ważnymi opcjami na dany moment. Końcowe zachowanie wynika z symbiozy między monitem użytkownika, który niesie ogólny zamiar („zagraj w bitwę Pokémon“), opisami narzędzi, które wyjaśniają, kiedy i jak użyć każdego narzędzia, oraz odpowiedziami narzędzi, które określają, którego narzędzia użyć dalej i z jakimi argumentami.

Przed podłączeniem tego serwera do Vibe, zespół Mistral uruchamia go przez MCP Inspector: weryfikując, czy battle_player odpowiada poprawnie początkowym stanem bitwy, testując akcje bitewne jedna po drugiej, upewniając się, że instrukcje prowadzenia są obecne w odpowiedziach, oraz walidując format JSON parametrów i odpowiedzi. W grze turowej najmniejszy błąd formatowania przerywa mecz; Inspector pozwala na debugowanie bez zużywania wiadomości konwersacji.

Zasady stosowane w Twoich projektach

Pierwszą przenoszalną zasadą jest zarządzanie stanem w odpowiedziach. Każdy system ewoluujący w trakcie interakcji – proces zamówienia, potok CI/CD, przepływ walidacji – korzysta na tym, że serwer zwraca bieżący stan i dostępne akcje na każdym kroku. Serwer MCP zarządzający zamówieniami zwracałby zatem status zamówienia i dostępne następne kroki: zatwierdź płatność, potwierdź wysyłkę, anuluj.

Drugą jest integrowanie instrukcji przepływu pracy w odpowiedziach, a nie w monocie użytkownika, gdzie logika byłaby długa do napisania i krucha w utrzymaniu. Serwer MCP do wdrażania mógłby na przykład odpowiedzieć po udanym kroku: „Testy przeszły pomyślnie. Użyj narzędzia ‘deploy_staging’, aby wdrożyć na środowisko staging“.

Trzecia dotyczy jasnych, typowanych opisów. Każde narzędzie w serwerze Pokémon ma precyzyjny opis, typowane parametry i udokumentowane wartości zwracane, dzięki czemu model dokładnie wie, co narzędzie robi i jakie argumenty podać. Zastosowane do logiki biznesowej oznacza to jawne nazywanie (create_invoice zamiast process), użyteczne typowanie (user_email: string zamiast user: string) oraz opisywanie oczekiwanych zwrotów.

Czwarta to dekompozycja na wyspecjalizowane narzędzia. Serwer nie oferuje jednego narzędzia „play_pokemon“, które obsługuje wszystko: każda akcja ma swoje własne narzędzie i odpowiedzialność. Podobnie, preferuj start_order, add_item, confirm_payment i track_shipment zamiast ogólnego manage_order, które trudniej opisać, a przez to częściej jest źle używane.

Ograniczenia czasu rzeczywistego

Demo podkreśla również obecne ograniczenie: serwery MCP w Vibe nie obsługują jeszcze natywnie długotrwałych zadań ani strumieniowania w czasie rzeczywistym, ponieważ każde wywołanie narzędzia czeka na synchroniczną odpowiedź. Dla systemów wymagających ciągłych aktualizacji zalecanym obejściem jest udostępnienie narzędzia start_task, które uruchamia operację, oraz narzędzia get_status, które użytkownik wywołuje, aby sprawdzić postęp.

Kluczowe wnioski

  • Przypadek Pokémon Showdown ilustruje zaawansowane wzorce MCP stosowane w dowolnym projekcie
  • Prowadzenie przez odpowiedź to potężny wzorzec do orkiestracji wieloetapowych przepływów pracy
  • Opisy narzędzi, ustrukturyzowane odpowiedzi i dekompozycja na wyspecjalizowane narzędzia to klucze do dobrego serwera MCP
  • Zawsze testuj za pomocą MCP Inspector przed integracją z Vibe
  • Zasady są identyczne dla gry jak i złożonego procesu biznesowego