A MCPHub egy nyílt forrású, saját szerveren futtatható MCP átjáró és vezérlőpult. Nem új képességet ad az ügynökeinknek, hanem rendet tesz azok között, amiket már használunk: a szétszórt MCP szervereket egyetlen, stabil végpont mögé gyűjti, és a hozzáférést is ugyanott szabályozza.

A projekt Apache 2.0 licenc alatt érhető el, Node.js alapon fut, és Dockerrel egyetlen paranccsal elindul. A webfelületen kezeljük a szervereket, a csoportokat, a kulcsokat és a naplókat.

Mire használjuk nálunk?

Egy végpont, több szerver. A /mcp végpont az összes csatlakoztatott MCP szervert kiszolgálja, így a klienseknek nem kell ismerniük minden szerver külön címét és indítási módját.
Csoportok. A szervereket logikai csoportokba rendezzük, és minden csoport saját végpontot kap (/mcp/{group}). Egy adott feladatra indított ügynök így csak a releváns eszközöket látja, nem a teljes készletet.
Egy szerverre szűkítés. Ha csak egy konkrét szerver kell, az is elérhető saját útvonalon (/mcp/{server}).
Eszközkeresés feladatból. A $smart végponton a kliens nem eszközneveket sorol fel, hanem leírja, mit szeretne elérni, és a hub vektoros, szemantikus kereséssel választja ki a releváns eszközöket.

Hogyan épül fel?

Konfiguráció. A szerverek listája egy mcp_settings.json fájlban él, de a dashboardról is szerkeszthető. A beállítás leállás nélkül cserélhető, új szervert futás közben is felvehetünk.
Átvitelek. A hub a stdio, az SSE és a streamable HTTP protokollt is támogatja, így helyi és távoli szerverek egyaránt csatlakoztathatók.
Tárolás. Alapértelmezésben fájl alapú; éles üzemhez PostgreSQL mód van, a vektoros keresés pedig a pgvector kiterjesztést használja.
Hozzáférés. Helyi fiók JWT és bcrypt alapon, bearer kulcsok, valamint beépített OAuth 2.0 szerver. A GitHub és a Google bejelentkezés adatbázis módhoz kötött.
Szerverenkénti kulcsok. Egy megosztott szerverhez felhasználónként külön hitelesítő adat rendelhető, titkosított tárolással.

Üzemeltetés

Naplók és megfigyelés. Az eszközhívások, a kérések állapota és a válaszidő egy helyen látszik.
Állapotellenőrzés. A hub a kapcsolatok és a szerverek állapotát is figyeli.
Nagy válaszok. A nagy szöveges eszközkimeneteket a hub a kliensek felé menet csökkentheti, így kevesebb token kerül a kontextusba.
Konténer. Két hivatalos image van: az alapértelmezett, és egy bővebb változat Rust eszközlánccal, Docker Engine-nel és Playwright böngészőkkel.
Fej nélküli mód. A dashboard kikapcsolható, ekkor csak a háttérszolgáltatás és az MCP végpontok futnak.

Amire figyelni kell

A vektoros keresés külön komponenseket kér: PostgreSQL pgvectorrel és egy beágyazást készítő szolgáltatást. Ez önmagában is üzemeltetési feladat.
Az MCP végpontok alapértelmezésben hitelesítést kérnek. A hitelesítés kikapcsolása csak megbízható hálózatban indokolt.
A saját üzemeltetés azt is jelenti, hogy a frissítés, a mentés és a visszaállítás a mi feladatunk.
A projekt gyorsan fejlődik, ezért a konfigurációs fájl és a dashboard lehetőségei verzióról verzióra változhatnak.

Hogyan illeszkedik a rendszerünkbe?

Az MCP adja a szabványt, a MCPHub pedig a közös belépési pontot: ide csatlakoznak az eszközök, és innen kapják azokat az ügynökök. A Hermes Agent ügynök oldalról ugyanezt a hubot használja, magát a hubot pedig Docker konténerben futtatjuk.

Így egy helyen látjuk, melyik szerver mit tud, melyik ügynök mit érhet el, és ha egy szerver hibás, azt nem kell minden kliensnél külön javítani.

Tovább olvasás

MCPHub dokumentáció - a hivatalos oldal, innen indul minden beállítás.
Smart Routing - hogyan épül fel a vektoros eszközkiválasztás.
MCPHub a GitHubon - a forráskód, a kiadások és a licence (Apache 2.0).

Nálunk a CyberElectro a MCPHubot a helyi és a szerveren futó MCP szerverek egységes elérésére használja.