Zwracanie obrazów i danych binarnych
Odsyłaj nietekstową zawartość za pomocą narzędzia.
Zwracanie obrazów i danych binarnych to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej MCP Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs MCP Academy zawiera 4 lekcji w sumie.
Poza tekstem i JSON
Niektóre narzędzia tworzą obrazy lub pliki, a nie słowa. MCP może zwracać dane binarne, takie jak obrazy i inne bloby, a nie tylko tekst.
Typ treści obrazu
MCP definiuje typ treści image, który zawiera surowe bajty oraz typ multimedialny. Obsługujący go klienci mogą bezpośrednio wyświetlić obraz. 🖼️
Bajty są przesyłane jako Base64
Dane binarne są kodowane jako tekst base64, aby mogły bezpiecznie przejść przez komunikat JSON. Po odebraniu klient dekoduje je z powrotem do rzeczywistych bajtów.
Pomocnik Image
Python SDK udostępnia pomocnik Image, dzięki czemu nie trzeba ręcznie niczego kodować. Wystarczy wskazać bajty lub ścieżkę i je zwrócić.
from mcp.server.fastmcp import Image
return Image(data=png_bytes, format="png")Ustawianie typu multimedialnego
Należy zawsze określić format, na przykład png lub jpeg, aby klient wiedział, jak poprawnie zdekodować i wyświetlić obraz.
Zwracanie pliku z dysku
Należy odczytać plik do bajtów, a następnie opakować go do zwrócenia. Narzędzie zamienia zapisany wykres w czytelny wynik dla modelu i użytkownika.
data = open("chart.png", "rb").read()
return Image(data=data, format="png")Nie tylko obrazy
Oprócz obrazów MCP obsługuje ogólną treść typu blob dla innych danych binarnych, takich jak PDF lub dźwięk, z własnym typem multimedialnym.
Obsługa zależy od klienta
Nie każdy klient potrafi wyświetlić każdy typ. Host, który nie może wyrenderować obrazu, może użyć odnośnika lub linku do pobrania.
Należy uważać na rozmiar
Base64 zwiększa dane o około jedną trzecią, a duże bloby zużywają tokeny i przepustowość. Zwracane multimedia powinny być w miarę możliwości niewielkie.
Duże pliki lepiej udostępniać jako zasoby
W przypadku bardzo dużych lub współdzielonych plików należy udostępnić zasób za pomocą URI zamiast umieszczać bajty bezpośrednio w wyniku narzędzia. Klient pobierze go na żądanie.
Łączenie z tekstem
Można połączyć obraz z krótkim podpisem tekstowym w tym samym wyniku, zapewniając modelowi zarówno obraz, jak i słowa do analizy.
Szybkie sprawdzenie
W jaki sposób dane binarne są przesyłane w komunikacie MCP?
Podsumowanie: obrazy i bloby
Mogą Państwo zwracać obrazy i bloby binarne za pomocą base64 wraz z typem multimedialnym, ustawiać format, pamiętać o rozmiarze i wybierać zasoby dla dużych plików. ✅
Często zadawane pytania
Czy lekcja „Zwracanie obrazów i danych binarnych” jest bezpłatna?
Tak — pełny tekst „Zwracanie obrazów i danych binarnych” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu MCP Academy, przejdź na CoddyKit PRO. Kurs MCP Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Zwracanie obrazów i danych binarnych”?
Odsyłaj nietekstową zawartość za pomocą narzędzia. Ćwiczysz MCP Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć MCP Academy?
Nie wymagamy żadnego doświadczenia. MCP Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Zwracanie obrazów i danych binarnych”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji MCP Academy?
Tak. Każda lekcja MCP Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Treść tekstowa a ustrukturyzowana
- Zwracanie typowanego obiektu wyniku
- Schematy danych wyjściowych dla klientów
- Zwracanie obrazów i danych binarnych