Jak korzystać z serwera MCP
Serwer MCP pozwala asystentowi przeszukiwać i odczytywać 838 artykułów oraz 11 podstron z archiwum zlotoryja1211.pl. Zwraca tekst, autora, daty publikacji i modyfikacji oraz odnośniki do zdjęć i załączników.
Publiczny serwer MCP: https://zlotoryja1211.pl/mcp. W aplikacji wybierz zdalny serwer MCP i transport Streamable HTTP. Instalacja Pythona nie jest potrzebna. Poniżej opisano opcjonalny wariant lokalny.
1. Pobierz paczkę
Pobierz serwer MCP i dane archiwum (ZIP). Rozpakuj plik i przejdź do folderu zlotoryja1211-mcp. Paczka zawiera kod i JSON-y publikacji. Zdjęcia i załączniki są wskazywane przez adresy w serwisie.
2. Zainstaluj zależności
Wymagany jest Python 3.11 lub nowszy z modułami venv i SQLite FTS5. W terminalu, wewnątrz rozpakowanego folderu, uruchom:
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-mcp.txt
Na Debianie i Ubuntu może być potrzebny pakiet python3-venv. W Windows zamiast .venv/bin/python użyj .venv\Scripts\python.exe.
3. Połącz klienta przez stdio
W konfiguracji aplikacji obsługującej MCP dodaj poniższy serwer. Zastąp /PELNA/SCIEZKA rzeczywistą, bezwzględną ścieżką do rozpakowanego folderu. Zachowaj pozostałe wpisy w konfiguracji klienta.
{
"mcpServers": {
"zlotoryja1211": {
"command": "/PELNA/SCIEZKA/zlotoryja1211-mcp/.venv/bin/python",
"args": ["/PELNA/SCIEZKA/zlotoryja1211-mcp/scripts/mcp_server.py"]
}
}
}
W tym trybie klient sam uruchamia serwer. Serwer nie otwiera portu i nie zmienia danych archiwum. Format ustawień może się różnić między klientami MCP.
Alternatywa: lokalne HTTP
.venv/bin/python scripts/mcp_server.py --transport streamable-http --port 8082
Następnie połącz klienta MCP z http://127.0.0.1:8082/mcp. To adres protokołu, a nie strona HTML. Serwer nasłuchuje wyłącznie na Twoim komputerze. Samo opublikowanie tej instrukcji nie uruchamia MCP na hostingu.
Co można wywołać
search_entries— wyszukuje w pełnej treści, tytułach, autorach i kategoriach. Obsługuje filtry dat, autora i typu publikacji.list_entries— lista wpisów lub podstron, z datami i stronicowaniem.get_entry— odczyt publikacji po ID, slugu lub oryginalnym adresie.get_archive_info— zakres archiwum, autorzy, lata i kategorie.
Przykładowe argumenty do search_entries:
{"query":"szpital", "author":"Pawlowski", "date_from":"2017-01-01", "date_to":"2017-12-31"}
Wyszukiwanie ignoruje polskie znaki i wielkość liter. Wszystkie słowa zapytania muszą pasować jako prefiksy; nie wykonuje odmiany gramatycznej. Daty filtrów dotyczą publikacji i są włączne. Kolejne wyniki pobierzesz, przekazując offset równy otrzymanemu next_offset.
Przykładowe argumenty do get_entry:
{"reference":"https://zlotoryja1211.pl/2020/07/09/sprawy-z-powiatu-zlotoryjskiego-w-wsa/"}
Długie teksty mają własne next_offset; pobieraj kolejne części, aż będzie równe null. Serwer udostępnia także zasoby archive://info i archive://publication/4583. O sposobie pokazania wyników i zdjęć decyduje klient MCP.
Charakter danych
To archiwum historyczne: artykuły opublikowano w latach 2016–2020. Treści zachowują wersję z przekazanej kopii WordPressa. Nie należy traktować dawnych informacji jako opisu bieżącej sytuacji. Przy cytowaniu podawaj autora, datę publikacji i oryginalny adres wpisu. Serwer tylko odczytuje JSON-y, a indeks wyszukiwania buduje w pamięci. Paczka jest migawką danych z momentu jej przygotowania.
llms.txt — przewodnik po archiwum dla modeli językowych · Instrukcja w Markdown · Dokumentacja oficjalnego SDK MCP