Keycloak MCP Server

Co dělá „Keycloak“ MCP Server?

Keycloak MCP (Model Context Protocol) Server je specializovaný nástroj, který umožňuje správu uživatelů a realmů Keycloak s podporou AI. Funguje jako most mezi AI asistenty a Keycloakem a dovoluje externím klientům (například Claude Desktop a dalším MCP-kompatibilním platformám) automatizovat úkoly správy uživatelů a realmů. Přes rozhraní MCP mohou vývojáři bezproblémově provádět operace jako vytváření a mazání uživatelů, výpis realmů a uživatelů. To zlepšuje vývojové a DevOps workflow tím, že AI agenti mohou programově komunikovat s autentizační a uživatelskou infrastrukturou, což zefektivňuje rutinní administrativní úkoly a snižuje ruční zásahy.

Seznam promptů

V repozitáři nejsou uvedeny žádné šablony promptů.

Seznam zdrojů

V repozitáři nejsou zdokumentovány žádné explicitní zdroje.

Seznam nástrojů

• create-user
  Vytvoří nového uživatele ve zvoleném realmu.
  Vstupy: realm, username, email, firstName, lastName

• delete-user
  Smaže uživatele ze zvoleného realmu.
  Vstupy: realm, userId

• list-realms
  Vypíše všechny dostupné realmy Keycloak.

• list-users
  Vypíše všechny uživatele v určeném realmu.
  Vstupy: realm

Scénáře použití tohoto MCP serveru

• Automatizované zakládání uživatelů
  Vývojáři nebo DevOps inženýři mohou automatizovat zakládání nových uživatelů napříč různými realmy, což snižuje ruční zásahy a zajišťuje jednotný onboarding.
• Hromadná správa uživatelů
  Snadno vypisujte nebo odstraňujte uživatele ve specifických realmech, což je vhodné pro správu rozsáhlých prostředí s mnoha účty.
• Administrace realmů
  Rychle zjistíte seznam všech dostupných realmů, což je užitečné v multi-tenant nebo multi-enviroment scénářích, kdy je třeba spravovat více realmů najednou.
• Integrace s AI agenty
  Umožněte AI asistentům řešit opakované administrativní úkoly v Keycloak, jako je vytváření testovacích uživatelů pro QA nebo úklid demo prostředí po testování.
• Samoobslužné portály
  Umožněte koncovým uživatelům nebo týmům podpory provádět rutinní správu uživatelů přes AI rozhraní, čímž zrychlíte reakční dobu a snížíte zátěž podpory.

Jak nastavit

Windsurf

1. Ujistěte se, že máte v systému nainstalovaný Node.js.
2. Najděte svůj konfigurační soubor Windsurf.
3. Přidejte Keycloak MCP Server pomocí tohoto JSON úryvku:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Windsurf.
5. Ověřte nastavení tím, že zkontrolujete, zda se Windsurf dokáže připojit ke Keycloak MCP Serveru.

Claude

1. Ujistěte se, že máte nainstalovaný Node.js.
2. Otevřete svůj konfigurační soubor Claude Desktop.
3. Vložte tuto konfiguraci pod mcpServers:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Uložte soubor a restartujte Claude Desktop.
5. Potvrďte připojení ke Keycloak MCP Serveru.

Cursor

1. Ujistěte se, že je Node.js nastaven.
2. Najděte a otevřete konfigurační soubor Cursor.
3. Přidejte údaje Keycloak MCP Serveru:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Uložte konfiguraci a restartujte Cursor.
5. Zkontrolujte úspěšné připojení.

Cline

1. Nainstalujte Node.js, pokud není již přítomen.
2. Otevřete konfigurační soubor Cline.
3. Přidejte tuto konfiguraci MCP Serveru:

   {
     "mcpServers": {
       "keycloak": {
         "command": "npx",
         "args": ["-y", "keycloak-model-context-protocol"],
         "env": {
           "KEYCLOAK_URL": "http://localhost:8080",
           "KEYCLOAK_ADMIN": "admin",
           "KEYCLOAK_ADMIN_PASSWORD": "admin"
         }
       }
     }
   }
   

4. Uložte změny a restartujte Cline.
5. Ověřte, že Cline rozpoznal Keycloak MCP Server.

Zabezpečení API klíčů

Doporučujeme používat environmentální proměnné pro citlivé informace jako admin přihlašovací údaje. Příklad konfigurace:

{
  "mcpServers": {
    "keycloak": {
      "command": "npx",
      "args": ["-y", "keycloak-model-context-protocol"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "${KEYCLOAK_ADMIN}",
        "KEYCLOAK_ADMIN_PASSWORD": "${KEYCLOAK_ADMIN_PASSWORD}"
      }
    }
  }
}

Před spuštěním aplikace nastavte proměnné prostředí KEYCLOAK_ADMIN a KEYCLOAK_ADMIN_PASSWORD bezpečně ve vašem systému.

Jak používat tento MCP uvnitř toků

Použití MCP ve FlowHunt

K integraci MCP serverů do vašeho workflow FlowHunt začněte přidáním MCP komponenty do toku a její propojení s AI agentem:

Klikněte na MCP komponentu pro otevření panelu konfigurace. Do sekce systémové konfigurace MCP vložte údaje vašeho MCP serveru v tomto formátu JSON:

{
  "keycloak": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po konfiguraci může AI agent tento MCP používat jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “keycloak” na skutečný název vašeho MCP serveru a URL na vlastní adresu MCP serveru.

Přehled

Na základě dostupné dokumentace a funkcí poskytuje Keycloak MCP Server solidní základní nástroje pro správu Keycloak, ale chybí mu pokročilé MCP funkce jako šablony promptů, explicitní zdroje nebo podpora vzorkování. Jeho hlavní hodnota spočívá v jednoduché správě uživatelů/realmů přes AI rozhraní.

MCP skóre

Celkové hodnocení:
Tento MCP server hodnotím 5/10. Nabízí základní, dobře zdokumentované nástroje pro správu Keycloak, ale chybí mu pokročilé MCP funkce a nemá LICENSE soubor, což omezuje jeho rozšíření a rozšiřitelnost.