Keycloak MCP Server

Co robi serwer MCP „Keycloak”?

Keycloak MCP (Model Context Protocol) Server to wyspecjalizowane narzędzie umożliwiające zarządzanie użytkownikami i realmami Keycloak z wykorzystaniem AI. Działa jako pomost pomiędzy asystentami AI a Keycloak, pozwalając zewnętrznym klientom (takim jak Claude Desktop czy inne platformy zgodne z MCP) na automatyzację zadań związanych z zarządzaniem użytkownikami i realmami. Poprzez interfejs MCP deweloperzy mogą płynnie wykonywać operacje takie jak tworzenie i usuwanie użytkowników, listowanie realmów oraz użytkowników. Zwiększa to efektywność pracy zespołów developerskich i DevOps, ponieważ agent AI może programowo współpracować z infrastrukturą uwierzytelniania i zarządzania użytkownikami, usprawniając rutynowe zadania administracyjne i ograniczając ręczne czynności.

Lista Promptów

Brak szablonów promptów wymienionych w repozytorium.

Lista Zasobów

Brak udokumentowanych, jawnych zasobów w repozytorium.

Lista Narzędzi

• create-user
  Tworzy nowego użytkownika w wybranym realmie.
  Wejścia: realm, username, email, firstName, lastName

• delete-user
  Usuwa użytkownika z wybranego realmu.
  Wejścia: realm, userId

• list-realms
  Wyświetla wszystkie dostępne realmy Keycloak.

• list-users
  Wyświetla wszystkich użytkowników w wybranym realmie.
  Wejścia: realm

Przypadki użycia tego serwera MCP

• Automatyczne przydzielanie użytkowników
  Deweloperzy lub inżynierowie DevOps mogą automatyzować proces tworzenia nowych użytkowników w różnych realmach, ograniczając manualną pracę i zapewniając spójny onboarding.
• Masowe zarządzanie użytkownikami
  Łatwo listuj lub usuwaj użytkowników w wybranych realmach – idealne dla środowisk z dużą liczbą kont.
• Administracja realmami
  Szybko pobieraj listę wszystkich dostępnych realmów, co ułatwia zarządzanie wieloma środowiskami lub tenantami.
• Integracja z agentami AI
  Pozwól asystentom AI obsługiwać powtarzalne zadania administracyjne Keycloak, np. tworzenie użytkowników testowych na potrzeby QA lub czyszczenie środowisk demo po testach.
• Portale samoobsługowe
  Umożliw użytkownikom końcowym lub zespołom wsparcia wykonywanie rutynowych operacji zarządzania użytkownikami przez interfejsy AI, skracając czas reakcji i zmniejszając obciążenie wsparcia.

Jak skonfigurować

Windsurf

1. Upewnij się, że Node.js jest zainstalowany na Twoim systemie.
2. Zlokalizuj plik konfiguracyjny Windsurf.
3. Dodaj Keycloak MCP Server, używając poniższego fragmentu JSON:

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

4. Zapisz konfigurację i zrestartuj Windsurf.
5. Zweryfikuj konfigurację sprawdzając, czy Windsurf łączy się z Keycloak MCP Server.

Claude

1. Upewnij się, że Node.js jest zainstalowany.
2. Otwórz plik konfiguracyjny Claude Desktop.
3. Wstaw poniższą konfigurację 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. Zapisz plik i zrestartuj Claude Desktop.
5. Potwierdź połączenie z Keycloak MCP Server.

Cursor

1. Upewnij się, że Node.js jest zainstalowany.
2. Znajdź i otwórz plik konfiguracyjny Cursor.
3. Dodaj szczegóły Keycloak MCP Server:

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

4. Zapisz konfigurację i zrestartuj Cursor.
5. Sprawdź, czy połączenie się powiodło.

Cline

1. Zainstaluj Node.js, jeśli nie jest jeszcze obecny.
2. Uzyskaj dostęp do pliku konfiguracyjnego Cline.
3. Dodaj poniższą konfigurację MCP Server:

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

4. Zapisz zmiany i zrestartuj Cline.
5. Zweryfikuj, że Cline rozpoznaje Keycloak MCP Server.

Bezpieczne przechowywanie kluczy API

Zaleca się używanie zmiennych środowiskowych do poufnych danych, takich jak dane administratora. Przykładowa konfiguracja:

{
  "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}"
      }
    }
  }
}

Ustaw zmienne środowiskowe KEYCLOAK_ADMIN oraz KEYCLOAK_ADMIN_PASSWORD bezpiecznie w systemie przed uruchomieniem aplikacji.

Jak używać tego MCP we flows

Używanie MCP w FlowHunt

Aby zintegrować serwery MCP z workflow FlowHunt, zacznij od dodania komponentu MCP do swojego flow i połącz go z agentem AI:

Kliknij komponent MCP, aby otworzyć panel konfiguracyjny. W sekcji konfiguracyjnej MCP systemu wklej dane serwera MCP w tym formacie JSON:

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

Po skonfigurowaniu agent AI może korzystać z tego MCP jako narzędzia ze wszystkimi jego funkcjami i możliwościami. Pamiętaj, aby zamienić “keycloak” na nazwę swojego serwera MCP i podać własny adres URL.

Przegląd

Na podstawie dostępnej dokumentacji i funkcji, Keycloak MCP Server zapewnia solidne podstawowe narzędzia do administracji Keycloak, lecz brakuje mu zaawansowanych funkcji MCP jak szablony promptów, jawne zasoby czy wsparcie sampling-u. Jego główną wartością jest proste zarządzanie użytkownikami/realmami przez interfejsy AI.

Wynik MCP

Ocena końcowa:
Oceniam ten serwer MCP na 5/10. Oferuje niezbędne, dobrze udokumentowane narzędzia do administracji Keycloak, ale brakuje mu zaawansowanych funkcji MCP oraz pliku LICENSE, co ogranicza możliwości jego wdrożenia i rozwoju.