# 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)](downloads/zlotoryja1211-mcp.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](llms.txt) · [Instrukcja w Markdown](mcp.md) · [Dokumentacja oficjalnego SDK MCP](https://py.sdk.modelcontextprotocol.io/)
