Googleov Java klijent za MCP Toolbox for Databases dostigao je verziju 1.0.0 9. septembra. U objaviod 6. oktobra, kompanija je detaljno opisala promene transporta, autentifikacije i parametara alata za timove koji povezuju Java aplikacije sa zasebno pokrenutim Toolbox serverom. Zapis izdanja datira objavu koda skoro mesec dana pre te objave.

Ta razlika je važna za Java tim koji odlučuje da li sada da usvoji klijent. Google naziva izdanje 1.0 stabilnom osnovom kompatibilnom sa prethodnim verzijama, ali isti zapis navodi nekompatibilnu izmenu: vezani parametri se uklanjaju iz definicije alata koja se prikazuje agentu. Postojeće integracije treba da provere kako koriste te definicije pre nadogradnje. Googleov repozitorijum takođe navodi da je podrška Java funkcijama još u razvoju i da ne dostiže Python, JavaScript/TypeScript i Go SDK-ove.

Šta se menja

Klijent 1.0 pruža Java aplikaciji definisan način da otkrije i pozove alate koje izlaže MCP Toolbox. Njegov novi HttpMcpTransport nalazi se iza transportnog interfejsa, dok CredentialsProvider i AuthMethods razdvajaju razrešavanje akreditiva od klijenta. Google kaže da se akreditivi razrešavaju asinhrono za svaki zahtev. Izdanje dodaje i podrazumevane vrednosti parametara, HTTP upozorenja o izlaganju akreditiva, izbor verzije, praćenje sesija i mapu prilagođenih zaglavlja zahteva. To su dokumentovane funkcije SDK-a, a ne BIG CHANGE test performansi ili bezbednosti.

Sam Toolbox je zaseban server. Operater ga podešava izvorima podataka i alatima; Java klijent se povezuje na njegov URL, učitava definicije alata i šalje pozive. Sama Java zavisnost ne podešava bazu podataka, ne daje dozvole niti postavlja taj server. Zvanična Java dokumentacija opisuje uloge klijenta i servera, a repozitorijum SDK-a zahteva da server radi pre podešavanja klijenta.

Šta Java tim može da proceni

Sledeći postupak potiče iz Googleove dokumentacije i repozitorijuma. BIG CHANGE nije pokrenuo kod niti se povezao sa bazom podataka.

  1. Pripremite zaseban Toolbox server i izvor podataka. Googleova dokumentacija za početak pokriva server, definicije alata i podržane integracije. Za prvu procenu izaberite usko ograničen alat baze podataka samo za čitanje i pregledajte kontrole pristupa servera. Repozitorijum SDK-a navodi Java 17 ili noviji kao osnovno okruženje.
  2. Fiksirajte Java zavisnost. I objava izdanja 1.0 i repozitorijum prikazuju Maven koordinate com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0; repozitorijum navodi i Gradle oblik. Opšta Java dokumentacija i dalje koristi VERSION rezervno mesto, pa je artefakt izdanja precizan izvor za ovu procenu.
  3. Povežite se sa serverom i pregledajte alat. Usmerite McpToolboxClient na URL pokrenutog servera /mcp , pa upotrebite loadToolset, listTools ili loadTool da pregledate objavljene definicije pre poziva. Repozitorijum prikazuje poziv pomoću Java Map i vraćeni tekstualni rezultat. Uspešna provera je odgovor imenovanog, podešenog alata, a ne samo kreiranje objekta klijenta bez greške.
  4. Pažljivo izaberite autentifikaciju. Objava 1.0 opisuje CredentialsProvider i AuthMethods za akreditive klijenta, uključujući Google Application Default Credentials putanju za OIDC. Opisuje i HTTP upozorenja kada bi akreditivi putovali u otvorenom tekstu. Upozorenje nije zamena za HTTPS krajnju tačku ili autorizaciju na serveru. Vezane vrednosti osetljivih parametara treba pregledati na granici servera i klijenta, naročito pri nadogradnji sa pretpregledne verzije.

Treba tražiti definiciju alata i rezultat koji odgovaraju dozvolama baze podataka namenjenim agentu. Ako otkrivanje ne uspe, prvo proverite URL servera, dostupno ime alata i podešavanje autentifikacije. Ako poziv ne uspe, uporedite potrebne parametre alata sa poslatim vrednostima i pregledajte zapise servera. To su dijagnostičke provere zasnovane na dokumentovanom razdvajanju komponenti, a ne tvrdnja da će se određena instalacija automatski oporaviti.

Ograničenja i trošak

Googleova primer aplikacije za prevoz prikazuje Spring Boot i LangChain4j kako pozivaju Toolbox alate povezane sa AlloyDB-om. Oktobarski članak navodi da je Cymbal Transit izmišljen. To je prikaz dizajna integracije, a ne izmerena upotreba kod korisnika ili rezultat pouzdanosti.

Repozitorijum Java SDK-a ima Apache 2.0 licencu. To ne određuje cenu baze podataka, cloud postavke, poziva modela ili mrežnog saobraćaja; timovi treba da procene izabrane usluge. Repozitorijum označava GraalVM native-image kao eksperimentalni i upozorava da podrška Java SDK funkcijama nije potpuna u odnosu na druge Toolbox klijente. Proverite ta ograničenja u odnosu na konkretni okvir i izvor podataka pre nego što Googleovu tvrdnju o pogodnosti za preduzeća smatrate potvrđenom za produkcioni sistem.

Izvori i dodatno čitanje