Wyjaśnienie identyfikatorów URI zasobów
Dowiedz się, jak adresować zasoby za pomocą schematu i ścieżki.
Wyjaśnienie identyfikatorów URI zasobów to bezpłatna lekcja MCP Academy na CoddyKit. To lekcja 1 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.
Czym jest zasób
Zasób MCP to dostępny tylko do odczytu kontekst, który serwer przekazuje modelowi, na przykład plik, konfiguracja lub rekord. Sztuczna inteligencja może go odczytać, ale nigdy go nie modyfikuje.
Dlaczego adres
Każdy zasób potrzebuje stałej nazwy, aby klient mógł poprosić o niego przez odwołanie. Ta nazwa to jego URI, podobnie jak strona internetowa ma adres URL. 🔗
Najpierw schemat, potem ścieżka
URI zasobu składa się ze schematu, następnie dwukropka i ukośników, a potem ścieżki. Schemat określa rodzaj elementu, na który wskazuje URI.
file:///notes/today.txt
config://app/settingsWybierz własny schemat
Możesz wymyślić schemat pasujący do Twojego serwera, na przykład config lub db. Schemat grupuje powiązane zasoby pod jedną, jasną etykietą.
Schemat file
Schemat file jest często używany w przypadku dokumentów zapisanych na dysku. Trzy ukośniki oznaczają, że ścieżka zaczyna się w katalogu głównym, podobnie jak adresy file w przeglądarce.
file:///home/data/report.mdPrzykład niestandardowego schematu
W przypadku danych aplikacji przejrzysty niestandardowy schemat ułatwia odczyt. Model widzi nazwę, która dokładnie informuje, co zawiera zasób.
users://profile/active
weather://city/londonURI muszą być unikatowe
Każdy zasób potrzebuje własnego, odrębnego URI, aby żądania nigdy nie były niejednoznaczne. Dwa zasoby współdzielące jedno URI kolidowałyby ze sobą i wprowadzały klientów w błąd.
Deklarowanie w FastMCP
W Python SDK przypisujesz URI do funkcji za pomocą dekoratora zasobu. Ten ciąg znaków jest adresem używanym przez klientów do odczytu zasobu.
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("Demo")
@mcp.resource("config://app")
def config(): ...Klienci wyświetlają listę URI
Po połączeniu klient prosi serwer o wyświetlenie listy wszystkich oferowanych zasobów. Każdy wpis zawiera URI, nazwę i krótki opis.
Odczyt przez URI
Aby pobrać zawartość, klient wysyła żądanie odczytu z dokładnym URI. Serwer dopasowuje URI do procedury obsługi i zwraca treść.
Zachowuj stałość URI
Traktuj opublikowane URI jak obietnicę. Późniejsza zmiana nazwy zepsuje działanie każdego klienta lub zapisanego odwołania wskazującego na stary adres.
Szybkie sprawdzenie
Wskaż element definiujący typ zasobu.
Podsumowanie
Zasoby to dostępny tylko do odczytu kontekst oznaczony przez URI: schemat i ścieżkę. Zachowuj unikatowość i stałość URI, aby klienci mogli na nich polegać. ✅
Często zadawane pytania
Czy lekcja „Wyjaśnienie identyfikatorów URI zasobów” jest bezpłatna?
Tak — pełny tekst „Wyjaśnienie identyfikatorów URI zasobów” 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 „Wyjaśnienie identyfikatorów URI zasobów”?
Dowiedz się, jak adresować zasoby za pomocą schematu i ścieżki. Ć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 1 z 4.
Ile czasu zajmuje lekcja „Wyjaśnienie identyfikatorów URI zasobów”?
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