Udostępnianie statycznego zasobu tekstowego
Udostępnij modelowi stały dokument do odczytu.
Udostępnianie statycznego zasobu tekstowego to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 2 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.
Stały dokument
Najprostszy zasób jest statyczny: za każdym razem serwer zwraca stały ciąg znaków. To dobre rozwiązanie w przypadku tekstów pomocy, zasad lub uwag dotyczących konfiguracji.
Jedna funkcja, jedno URI
Udostępniasz go, pisząc funkcję w Pythonie i oznaczając ją URI zasobu. Gdy klient odczytuje to URI, funkcja uruchamia się i zwraca tekst.
Dekorator
Dekorator zasobu rejestruje funkcję pod jej URI. Przekazany ciąg znaków staje się adresem używanym przez klientów do pobierania zawartości.
@mcp.resource("info://welcome")
def welcome():
return "Welcome to the server!"Zwracanie zwykłego tekstu
W przypadku zasobu tekstowego wystarczy zwrócić ciąg znaków Pythona. SDK opakuje go w odpowiedź odczytu MCP, dzięki czemu klient otrzyma przejrzystą zawartość.
Nazywanie i opisywanie zasobu
Dodaj jasny opis zasobu, aby model wiedział, kiedy go odczytać. Docstring funkcji jest używany jako ten opis.
@mcp.resource("info://welcome")
def welcome():
"Greeting shown to new users."
return "Hello there!"Statyczny oznacza brak danych wejściowych
Zasób statyczny nie przyjmuje parametrów — zawsze zwraca tę samą treść. Jeśli potrzebujesz zmiennego wyniku, służą do tego szablony, które omówimy później.
Tworzenie tekstu w kodzie
Wartość zwracaną można złożyć w Pythonie przed wysłaniem. Dla klienta wynik nadal jest statyczny, ponieważ to samo wywołanie zwraca ten sam tekst.
@mcp.resource("config://limits")
def limits():
return "max_items=100\ntimeout=30"Dlaczego zasoby, a nie narzędzia
Używaj zasobu, gdy model musi jedynie odczytać kontekst. Narzędzia służą do wykonywania działań, a odczyt tekstu referencyjnego to dokładnie zadanie zasobów.
Model pobiera zawartość
Wiele hostów pozwala użytkownikowi dołączyć zasób do czatu, umieszczając jego zawartość w kontekście. Model może wtedy analizować ten tekst razem z poleceniem.
Zachowaj lekkość
Zasoby statyczne ładują się szybko, ponieważ nie wymagają wykonywania żadnych operacji. Przeznaczaj je na małe, stabilne teksty, aby nie zalewać modelu tokenami.
Testowanie zasobu
Uruchom serwer i użyj klienta, aby wyświetlić listę oraz odczytać URI. Jeśli wróci dokładnie podany przez Ciebie ciąg znaków, oznacza to, że zasób został prawidłowo podłączony.
Szybkie sprawdzenie
Wybór właściwego elementu dla stałego tekstu.
Podsumowanie
Zasób statyczny to funkcja działająca pod URI i zwracająca stały tekst. Dodaj opis w docstringu i zadbaj o niewielką treść. 📄
Często zadawane pytania
Czy lekcja „Udostępnianie statycznego zasobu tekstowego” jest bezpłatna?
Tak — pełny tekst „Udostępnianie statycznego zasobu tekstowego” 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 „Udostępnianie statycznego zasobu tekstowego”?
Udostępnij modelowi stały dokument do odczytu. Ć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 2 z 4.
Ile czasu zajmuje lekcja „Udostępnianie statycznego zasobu tekstowego”?
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
- Wyjaśnienie identyfikatorów URI zasobów
- Udostępnianie statycznego zasobu tekstowego
- Odczytywanie pliku z dysku
- Ustawianie właściwego typu MIME