README.md
Access ten Polish academic and government databases via AI-powered tools.
Polish Academic MCP
Zdalny serwer MCP działający na Cloudflare Workers, który udostępnia dziesięć polskich baz danych jako narzędzia wywoływane przez AI.
MCP (Model Context Protocol) to otwarty standard pozwalający modelom językowym (Claude, GPT, Bielik.AI itp.) na wywoływanie zewnętrznych narzędzi i API w ustandaryzowany sposób.
Dostępne bazy danych i narzędzia
| Narzędzie | Baza danych | Opis |
|---|---|---|
bn_search_articles |
Biblioteka Nauki | Przeszukiwanie polskich artykułów naukowych (OAI-PMH) |
bn_get_article |
Biblioteka Nauki | Pobranie szczegółów artykułu po ID |
ruj_search |
RUJ — Repozytorium UJ | Wyszukiwanie publikacji z Repozytorium Jagiellońskiego |
ruj_get_item |
RUJ | Pobranie metadanych pozycji po UUID |
agh_search |
AGH — Repozytorium AGH | Wyszukiwanie prac i publikacji AGH w Krakowie |
agh_get_item |
AGH | Pobranie metadanych pozycji po UUID |
amu_search |
AMU — Repozytorium UAM | Wyszukiwanie publikacji Uniwersytetu Adama Mickiewicza |
amu_get_item |
AMU | Pobranie metadanych pozycji po UUID |
uafm_search |
UAFM — Repozytorium UAFM | Wyszukiwanie publikacji Akademii Nauk Stosowanych w Nowym Sączu |
uafm_get_item |
UAFM | Pobranie metadanych pozycji po UUID |
icm_search |
ICM — Otwarte Dane Badawcze UW | Wyszukiwanie danych badawczych ICM UW |
icm_get_item |
ICM | Pobranie metadanych pozycji po UUID |
rodbuk_search |
RODBuK | Wyszukiwanie zbiorów danych badawczych uczelni krakowskich |
repod_search |
RePOD | Wyszukiwanie polskich otwartych danych badawczych |
repod_get_dataset |
RePOD | Pobranie metadanych zbioru danych po DOI |
dane_search |
dane.gov.pl | Wyszukiwanie danych otwartych z portalu rządowego |
dane_get_dataset |
dane.gov.pl | Pobranie szczegółów zbioru danych po ID |
imgw_synop |
IMGW-PIB | Aktualne odczyty ze stacji synoptycznych (pogodowych) |
imgw_hydro |
IMGW-PIB | Aktualne odczyty z wodowskazów i stacji hydrologicznych |
imgw_meteo |
IMGW-PIB | Aktualne odczyty ze stacji meteorologicznych |
imgw_warnings |
IMGW-PIB | Aktywne ostrzeżenia meteorologiczne i hydrologiczne |
Wszystkie bazy oferują otwarty, nieuwierzytelniony dostęp do odczytu — żadne klucze API nie są wymagane.
Wymagania dla developmnetu
- Node.js 18 lub nowszy
- Konto Cloudflare (darmowe)
- Wrangler CLI (instalowany jako zależność deweloperska)
Instalacja i uruchomienie lokalne
# 1. Sklonuj repozytorium
git clone https://github.com/asterixix/polish-academic-mcp.git
cd polish-academic-mcp
# 2. Zainstaluj zależności
npm install
# 3. Uruchom serwer deweloperski
npm run dev
# → Serwer MCP dostępny pod adresem http://localhost:8788/mcp
Testowanie z MCP Inspector
npx @modelcontextprotocol/inspector@latest
# Otwórz http://localhost:5173
# W polu "Server URL" wpisz: http://localhost:8788/mcp
# Kliknij "Connect"
Wdrożenie na Cloudflare Workers
Krok 1 — Zaloguj się do Cloudflare
npx wrangler login
Krok 2 — Utwórz przestrzenie nazw KV
npx wrangler kv namespace create "CACHE_KV"
# Skopiuj zwrócone "id" i wklej do wrangler.jsonc jako id dla CACHE_KV
npx wrangler kv namespace create "RATE_LIMIT_KV"
# Skopiuj zwrócone "id" i wklej do wrangler.jsonc jako id dla RATE_LIMIT_KV
Krok 3 — Zaktualizuj `wrangler.jsonc`
Otwórz wrangler.jsonc i zastąp wartości placeholder prawdziwymi ID:
"kv_namespaces": [
{
"binding": "CACHE_KV",
"id": "WKLEJ_TUTAJ_ID_CACHE_KV",
"preview_id": "WKLEJ_TUTAJ_ID_CACHE_KV"
},
{
"binding": "RATE_LIMIT_KV",
"id": "WKLEJ_TUTAJ_ID_RATE_LIMIT_KV",
"preview_id": "WKLEJ_TUTAJ_ID_RATE_LIMIT_KV"
}
]
Krok 4 — Wdróż
npm run deploy
# → Dostępny pod adresem: https://polish-academic-mcp.<twoje-konto>.workers.dev/mcp
Automatyczne wdrożenie przez GitHub Actions
Repozytorium zawiera gotowy workflow CI/CD (.github/workflows/deploy.yml).
Konfiguracja sekretów w GitHub
Przejdź do: GitHub → Settings → Secrets and variables → Actions i dodaj:
| Sekret | Wartość |
|---|---|
CLOUDFLARE_API_TOKEN |
Token API z Cloudflare Dashboard z uprawnieniami Workers:Edit i Workers KV:Edit |
CLOUDFLARE_ACCOUNT_ID |
ID twojego konta Cloudflare (widoczny w prawym panelu dashboardu) |
Po skonfigurowaniu sekretów każdy push na gałąź main automatycznie wdroży serwer.
Podłączenie klientów MCP
Claude Desktop
Dodaj do pliku konfiguracyjnego Claude Desktop (`claude_desktop_
Tools (7)
bn_search_articlesSearch for Polish scientific articles via Biblioteka Naukiruj_searchSearch publications in the Jagiellonian University Repositoryagh_searchSearch for AGH University publicationsamu_searchSearch publications from Adam Mickiewicz Universitydane_searchSearch open data from the Polish government portal dane.gov.plimgw_synopGet current weather readings from synoptic stationsimgw_warningsGet active meteorological and hydrological warningsEnvironment Variables
CLOUDFLARE_API_TOKENAPI token for Cloudflare deployment with Workers and KV permissionsCLOUDFLARE_ACCOUNT_IDID of the Cloudflare account for deploymentConfiguration
claude_desktop_config.json
{"mcpServers": {"polish-academic": {"command": "npx", "args": ["-y", "@asterixix/polish-academic-mcp"]}}}Try it
→Search for recent scientific articles about artificial intelligence in the Biblioteka Nauki database.
→Find open datasets related to air quality in Poland using the dane.gov.pl search tool.
→Check if there are any active meteorological warnings for my region.
→Retrieve metadata for the research publication with ID 12345 from the Jagiellonian University Repository.