MCP-kiszolgáló

A PostgreSQL kiterjesztés regisztrálhat egy Model Context Protocol (MCP) szerverdefiníciót a támogatott, MI-képes gazdakörnyezetekben. Ez a regisztráció lehetővé teszi, hogy a gazdagép felfedezze a PostgreSQL-eszközöket a kapcsolatkezeléshez, a sémafeltáráshoz, a lekérdezések végrehajtásához és a kapcsolódó munkafolyamatokhoz anélkül, hogy az egyes eszközöket kézzel kell konfigurálnia.

Ezen a lapon megértheti, hogyan működik az MCP-támogatás a bővítményben, mely gazdagépek támogatottak jelenleg, és mely eszközcsaládok válnak elérhetővé a regisztráció után.

Prerequisites

Mielőtt az MCP-kiszolgálóra támaszkodik, győződjön meg arról, hogy a következőt tette:

  • A Visual Studio Code-ba vagy a Cursorba telepített PostgreSQL-bővítmény.
  • Copilot/AI-funkciók engedélyezve a bővítményben (pgsql.copilot.enableistrue). A beállításazonosító mindkét szerkesztőben megőrzi az előtagot pgsql.copilot.* ; a címke AI-ként jelenik meg a kurzorban.
  • Legalább egy mentett kapcsolatprofil, ha azt szeretné, hogy az MCP-eszközök gyorsan csatlakozzanak a kiszolgálóhoz.
  • Egy támogatott gazdagép, amely egy MCP regisztrációs API-t tesz elérhetővé.

Az MCP-regisztráció működésének ismertetése

A bővítmény automatikusan regisztrálja az MCP-kiszolgálót, ha az alábbiak mindegyike igaz:

  1. A kiszolgáló egy támogatott MCP-regisztrációs API-t biztosít.
  2. A bővítmény lekérhet egy érvényes MCP-kiszolgáló URL-címet és tulajdonosi jogkivonatot a nyelvi szolgáltatásból.
  3. Copilot integráció engedélyezve van.

A kód elérési útja ma kifejezetten támogatja a következőket:

  • Visual Studio Code 1.102-es és újabb verziók az MCP-kiszolgálódefiníció-szolgáltató API-n keresztül
  • Cursor a Cursor registerServer MCP API-ján keresztül

A Visual Studio Code-ban a bővítmény PostgreSQL MCP néven regisztrálja a kiszolgálót. A Kurzorban a kiszolgálót pgsql-mcp néven regisztrálja.

Important

A bővítmény jelenleg nem kínál kézi másolásos-beillesztéses beállítási folyamatot azokhoz az önálló kliensekhez, amelyeknél neked kell megadnod az MCP URL-címet és a tokent. Ha a kliens nem támogatja a hosztszintű felderítést vagy regisztrációt, használja inkább a bővítmény beépített AI-munkafolyamatait.

Kapcsolatprofilok előkészítése MCP-eszközökhöz

A legtöbb hasznos MCP-folyamat a mentett kapcsolati információktól függ.

  1. Nyissa meg a Kapcsolatok és identitás elemet, majd hozza létre vagy frissítse azokat a kapcsolatprofilokat, amelyeket a gazdagép használni fog.
  2. Mentse a hitelesítő adatokat, ahol a munkafolyamat megköveteli őket.
  3. Ellenőrizze, hogy tud-e csatlakozni a céladatbázishoz a bővítményből, mielőtt az MCP-alapú automatizálásra támaszkodik.

Ez azért fontos, mert a kapcsolatorientált MCP-eszközök a célprofilt a bővítmény kapcsolattárolójából oldják fel, nem pedig az AI-gazdagép különálló adatbázis-konfigurációjából.

MCP-eszközök használata támogatott hoszton

Miután a gazdaalkalmazás felfedezi a PostgreSQL MCP-kiszolgálót, meghívhatja a bővítmény által elérhetővé tett eszközöket.

Eszközcsalád Miben segít? Tipikus használat
Kapcsolatprofilok listázása Mentett profilok felderítése Csatlakozás előtt keresse meg a megfelelő profilt
Csatlakozás a PostgreSQL-adatbázishoz Adatbázis-munkamenet megnyitása mentett profilból Feladat indítása a megfelelő kiszolgálón vagy adatbázisban
Adatbázisok listája Adatbázisok számbavétele a csatlakoztatott kiszolgálón Környezet váltása vagy az elérhető adatbázisok vizsgálata
Adatbázis-objektumok lekérése A séma környezetének lekérése Táblák, nézetek, függvények és egyéb objektumok azonosítása, mielőtt további kérdéseket tehetne fel
Lekérdezés futtatása Olvasási orientált SQL végrehajtása Adatok vizsgálata vagy feltételezések ellenőrzése
Adatbázis módosítása Adatok vagy sémamódosítások végrehajtása DDL vagy DML alkalmazása írási hozzáférést igénylő munkafolyamatokban
SQL-szkript megnyitása Szkript létrehozása felülvizsgálathoz Váltás az ügynök kimenetéről egy ember által ellenőrzött lekérdezésszerkesztő folyamatra
Lekérdezésterv A gyorsítótárazott terv adatainak vizsgálata Teljesítmény-munkafolyamatok elemzése
Adatbázisséma vizualizációja Sémanézet megjelenítése Kapcsolatok megismerése az SQL írása vagy módosítása előtt
Irányítópult kontextusának lekérése Aktív irányítópult-munkamenet kontextusának lekérése, beleértve az elérhető metrikákat és konfigurációt Metrikaadatok kérése előtt derítse fel, hogy mely metrikák érhetők el
Irányítópult metrikaadatainak lekérése Kötegelt gyorsítótárazott idősoradatok lekérése egy nyitott kiszolgáló irányítópultjáról Kiszolgálóteljesítmény-trendek elemzése élő lekérdezések futtatása nélkül

Tip

A biztonságosabb munkafolyamatok érdekében kezdje olyan felderítési eszközökkel, mint a Kapcsolatprofilok listázása, a Csatlakozás a PostgreSQL-adatbázishoz és az adatbázis-objektumok lekérése lekérdezések vagy módosítások futtatása előtt.

Választás az MCP és a beépített AI-szolgáltatások között

Az MCP-kiszolgálót akkor használja, ha a hoszt támogatja az MCP-felderítést, és azt szeretné, hogy a bővítmény ott elérhetővé tegye a PostgreSQL-eszközeit.

Használja a beépített bővítményszolgáltatásokat a következő esetekben:

  • közvetlenül a @pgsql csevegő résztvevőjével szeretne csevegni (csak Visual Studio Code),
  • többlépéses automatizálást szeretne az Ügynök módban (Visual Studio Code és Kurzor) vagy
  • A jelenlegi környezet nem jeleníti meg automatikusan a bővítmény MCP-regisztrációját.

Az MCP rendelkezésre állásának hibaelhárítása

A gazdaalkalmazás nem jelenít meg PostgreSQL MCP-kiszolgálót

Győződjön meg arról, hogy támogatott gazdakörnyezetet használ, és hogy a Copilot-/AI-integráció engedélyezve van a bővítményben. Szükség esetén a bejelentkezés vagy a Copilot/AI-beállítások módosítása után töltse be újra az ablakot.

A regisztráció ki van hagyva

A bővítmény kihagyja a regisztrációt, ha nem tud használható MCP URL-címet vagy jogkivonatot lekérni a nyelvi szolgáltatásból. Ellenőrizze a bővítmény kimeneti naplóit, ha a hoszt az újratöltés után sem találja meg a kiszolgálót.

Egy eszköz nem tud csatlakozni az adatbázishoz

Ellenőrizze, hogy létezik-e a célkapcsolati profil, és hogy a bővítmény használhatja-e közvetlenül. Az MCP-folyamatok ugyanazon kapcsolattárolótól és hitelesítő adatok felbontásától függnek, mint a bővítmény többi része.

Manuális végpontra van szükségem egy másik MCP-ügyfélhez

A bővítmény jelenleg nem biztosít felhasználói manuális végpont-munkafolyamatot önálló MCP-ügyfelek számára. Használjon támogatott gazdagépet, vagy térjen vissza a dokumentumkészletben dokumentált beépített AI-szolgáltatásokra.

Kapcsolódó tartalom

  • Last updated on