ARCHIWUM DLA ASYSTENTÓW AI

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ć

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