bpp-mcp

Serwer MCP dla API BPP (Bibliografia Publikacji Pracowników). Wystawia read-only, anonimowe API BPP (/api/v1/) jako zestaw starannie dobranych, typowanych narzędzi dla Claude Desktop, Claude Code, ChatGPT i innych klientów MCP.

Zamiast żmudnego chodzenia po hyperlinkach REST-owych (publikacja → autorzy → jednostka → …), serwer robi to za agenta: rozwija relacje, auto-follow-uje paginację i zwraca gotowe, zagnieżdżone obiekty.

Dlaczego MCP, a nie samo API?

API BPP jest hyperlinked — relacje to URL-e, nie zagnieżdżone dane. Pobranie jednego rekordu z autorami i źródłem to kilka–kilkanaście żądań. bpp-mcp ukrywa tę złożoność: pobierz_rekord zwraca jeden obiekt z rozwiniętymi autorami (nazwisko jak wydrukowane), źródłem i streszczeniami.

Szybki start

Uruchomienie z PyPI przez uv:

BPP_BASE_URL=https://bpp.twoja-uczelnia.pl uvx bpp-mcp

Serwer komunikuje się po stdio (standard MCP) — normalnie uruchamia go klient MCP, nie użytkownik ręcznie. Zajrzyj do:

• Instalacja — wymagania i sposoby instalacji.
• Konfiguracja — zmienne środowiskowe, wiele instancji BPP.
• Uwierzytelnianie — tryby anonimowy, per-user (stdio) i OAuth (HTTP).
• Klienci MCP — jak podłączyć bpp-mcp do Twojego asystenta.
• Narzędzia — co serwer udostępnia.
• DjangoQL — budowanie precyzyjnych zapytań.

Licencja

MIT — IPLWeb / Michał Pasternak. Patrz LICENSE.