⚡Model Context Protocol (MCP) Serveris

Prijunkite AI asistentus prie Lietuvos adresų registro

Sujunkite Cursor, Claude Desktop, Google Antigravity ar kitus AI agentus su oficialia Lietuvos pašto kodų ir adresų baze realiu laiku per saugų nuotolinį protokolą.

Nuotolinis SSE srautasBearer API autentifikacija800 000+ pastatų ir pašto kodųTik nuotolinis (Remote-Only)

🚀 Greitasis prijungimas prie AI klientų

Pasirinkite savo AI asistentą ir įklijuokite paruoštą konfigūraciją.

Atidarykite Cursor nustatymus (Settings → Features → MCP) arba sukurkite failą .cursor/mcp.json savo projekto šakniniame kataloge ir įklijuokite žemiau esančią konfigūraciją:

.cursor/mcp.json arba Cursor Settings → Features → MCP

{
  "mcpServers": {
    "adresuok-lt": {
      "url": "https://adresuok.lt/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_API_KEY"
      }
    }
  }
}

💡

Autentifikacijos raktas: Pakeiskite YOUR_MCP_API_KEY į savo suteiktą API raktą. Vystymo aplinkoje galite naudoti testinį raktą dev-mcp-key-adresuok.

⚙️ Techninės specifikacijos ir protokolas

Nuotolinio serverio parametrai, saugumas ir palaikomi transportai.

Prieigos taškas (Endpoint)

https://adresuok.lt/api/mcp

Palaiko Server-Sent Events (SSE) srautą (GET) ir JSON-RPC 2.0 žinučių siuntimą (POST).

Autentifikacija (Security)

Authorization: Bearer <API_KEY>

Privalomas Bearer žetonas. Serveris naudoja timingSafeEqual apsaugą nuo laiko atakų.

Užklausų limitas (Rate Limiting)

60 užklausų / minutę vienam raktui

Viršijus limitą grąžinamas HTTP 429 statusas su Retry-After antrašte.

Architektūra

Griežtai nuotolinis (Remote-Only)

Nereikalauja duomenų bazės atsisiuntimo; visi atsakymai generuojami realiu laiku iš VĮ Registrų centro indekso.

🛠️ Teikiami MCP įrankiai (Tools)

Visi 6 įrankiai, kuriuos jūsų AI asistentas gali išsikviesti automatiškai.

search_addressAdresų paieška laisvu tekstu

Suskleisti

Ieško Lietuvos adresų pagal laisvą tekstą, gatvę, namo numerį ar gyvenvietę. Grąžina iki N geriausiai atitinkančių adresų su pašto kodais ir reitingo balais.

Įvesties parametrai (Input Arguments):

Parametras	Tipas	Privalomas	Aprašymas
query	string	Taip	Paieškos frazė (pvz., "Gedimino pr. 9", "Savanorių Kaunas")
limit	number	Ne	Maksimalus rezultatų skaičius (numatytasis: 10, maks: 50)
city_filter	string	Ne	Papildomas filtras pagal miestą ar savivaldybę

Pavyzdinė užklausa modeliui: „Rask adresą Gedimino pr. 9 Vilniuje ir pateik jo pašto kodą.“

lookup_postal_codePaieška pagal 5 skaitmenų pašto kodą

Išskleisti

validate_and_normalize_addressAdreso validavimas ir VLKK normalizavimas

Išskleisti

get_address_detailsPilna hierarchinė adreso informacija

Išskleisti

list_administrative_divisionsAdministracinių vienetų sąrašas

Išskleisti

format_postal_labelSiuntos etiketės formavimas (VLKK)

Išskleisti

📚 Teikiami MCP resursai ir šablonai

Papildomi duomenų šaltiniai ir paruošti nurodymai AI asistentams.

📁MCP Resursai (Resources)

address://stats
Lietuvos adresų registro statistika ir indekso būsena.
address://counties
Visų 10 Lietuvos apskričių sąrašas su kodais.
address://municipalities
Visų 60 Lietuvos savivaldybių sąrašas.
address://building/{code}
Konkretaus pastato duomenys pagal unikalų AOB kodą.
address://postal-code/{code}
Visi pastatai ir gatvės pagal 5 skaitmenų pašto kodą.

💬MCP Šablonai (Prompts)

verify-customer-address
Išanalizuoja kliento laisvo teksto žinutę, ištraukia adreso elementus, patikrina registrą ir pasiūlo oficialų patikslintą adresą bei taisyklingą pašto kodą.
format-courier-dispatch
Paruošia standartizuotą siuntos gavėjo duomenų rinkinį Lietuvos Pašto, LP Express, Omniva ar DPD kurjerių sistemoms pagal VLKK taisykles.

❓ Dažniausiai užduodami klausimai (MCP DUK)

Atsakymai į klausimus apie serverio veikimą, saugumą ir pajungimą.

Kas yra Model Context Protocol (MCP)?

Model Context Protocol (MCP) – tai atviras standartas, leidžiantis dirbtinio intelekto modeliams (LLM) ir agentams saugiai pasiekti išorinius duomenų šaltinius ir įrankius tiesiogiai pokalbio metu be papildomo programavimo.

Kodėl paslauga teikiama tik nuotoliniu (Remote-Only) režimu?

Lietuvos adresų registras susideda iš daugiau nei 800 000 pastatų įrašų ir nuolat atnaujinamas. Nuotolinis MCP serveris užtikrina, kad jūsų AI agentai visada dirbtų su naujausiais valstybinio registro duomenimis ir nereikalautų didelių vietinių SQLite duomenų bazių atsisiuntimo.

Kaip gauti API prieigos raktą (Bearer Token)?

Produkcinėje aplinkoje susisiekite su Adresuok.lt administratoriais dėl dedikuoto API rakto. Vystymo ir vietinio testavimo tikslais galite naudoti testinį raktą „dev-mcp-key-adresuok“.

Ką daryti, jei AI klientas grąžina 401 Unauthorized klaidą?

Patikrinkite, ar MCP kliento konfigūracijoje nurodyta antraštė „Authorization: Bearer <JŪSŲ_RAKTAS>“. Įsitikinkite, kad tarp žodžio „Bearer“ ir rakto yra vienas tarpas.

Kokie taikomi užklausų limitai (Rate Limiting)?

Numatytasis limitas yra 60 užklausų per minutę vienam API raktui. Viršijus limitą, serveris grąžina HTTP 429 statusą su „Retry-After“ antrašte, nurodančia, po kelių sekundžių galima pakartoti užklausą.