Ustrukturyzowane logowanie do klienta

Drukowanie w terminalu pomaga tylko Tobie. MCP pozwala serwerowi wysyłać komunikaty log przez protokół, aby aplikacja hosta również mogła je wyświetlać.

Logi są przesyłane jako powiadomienie notifications/message. Zawiera ono poziom, opcjonalną nazwę rejestratora oraz dane, które chcesz zapisać.

Wewnątrz narzędzia uzyskujesz dostęp do logowania przez obiekt Context — ten sam uchwyt, którego używasz do raportowania postępu. Nie trzeba wykonywać dodatkowej konfiguracji.

Najczęściej używanym pomocnikiem jest ctx.info. Używaj go do zwykłych, oczekiwanych komunikatów o stanie, które pomagają użytkownikowi śledzić działanie narzędzia.

Sięgaj po ctx.debug, gdy potrzebujesz szczegółowych śladów, takich jak sparsowana wartość lub wybrana gałąź, które na co dzień powodują zbyt dużo szumu.

Używaj ctx.warning, gdy coś jest nieprawidłowe, ale można to naprawić, na przykład gdy brakuje opcjonalnego pola i uzupełniasz je wartością domyślną.

Wywołuj ctx.error w przypadku rzeczywistych problemów. Informuje on klienta, że krok się nie powiódł, niezależnie od zgłoszenia wyjątku, które kończy wywołanie.

MCP stosuje dobrze znaną skalę syslog: debug, info, notice, warning, error, critical i wyższe. Klienci mogą sortować komunikaty według poziomu i oznaczać je kolorami.

Wiele pomocników przyjmuje nazwę logger, dzięki czemu komunikaty można grupować według komponentu, podobnie jak robi to standardowy moduł logging języka Python.

Komunikaty logów opuszczają Twój proces i trafiają do klienta, więc traktuj je jako widoczne. Nigdy nie zapisuj w logu sekretów, takich jak tokeny czy hasła.

Podobnie jak postęp, każdy log jest powiadomieniem, więc nie blokuje narzędzia ani nie oczekuje odpowiedzi. Możesz swobodnie logować przebieg pracy.

Potrafisz już emitować logi z poziomami za pomocą ctx.info, debug, warning i error, nadawać nazwy rejestratorom oraz chronić sekrety. Świetne postępy!