Server Mcp di Keycloak

Cos'è il Protocollo di Contesto del Modello Keycloak?

Il Protocollo di Contesto del Modello Keycloak (MCP) è un'implementazione server innovativa progettata per gestire efficacemente gli utenti di Keycloak. Sfrutta l'amministrazione potenziata dall'IA per semplificare la gestione degli utenti e dei regni, rendendo più facile per le organizzazioni gestire le proprie esigenze di gestione dell'identità e degli accessi. L'MCP facilita l'integrazione senza soluzione di continuità con vari client, incluso Claude Desktop, consentendo operazioni utente automatizzate e capacità amministrative migliorate.

Caratteristiche del Protocollo di Contesto del Modello Keycloak

• Amministrazione Potenziata dall'IA: Utilizza l'intelligenza artificiale per automatizzare i compiti di gestione degli utenti, riducendo lo sforzo manuale e aumentando l'efficienza.
• Integrazione Senza Soluzione di Continuità: Funziona senza problemi con Claude Desktop e altri client MCP, abilitando operazioni automatizzate per la gestione degli utenti.
• Gestione degli Utenti e dei Regni: Semplifica l'amministrazione degli utenti e dei regni all'interno di Keycloak, fornendo un'interfaccia user-friendly per gli amministratori.
• Repository Pubblico: Il progetto è open-source e disponibile pubblicamente, consentendo agli sviluppatori di contribuire e migliorare la sua funzionalità.
• Comunità Attiva: Con un numero crescente di stelle e fork, l'MCP ha una comunità attiva che supporta il suo sviluppo e utilizzo.

Come Utilizzare il Protocollo di Contesto del Modello Keycloak

1. Installazione: Inizia clonando il repository da GitHub. Puoi usare il comando:

   git clone https://github.com/ChristophEnglisch/keycloak-model-context-protocol.git
   

2. Configurazione: Segui le istruzioni di installazione fornite nel file README del repository per impostare il server.
3. Configurazione: Configura l'MCP per connettersi con la tua istanza di Keycloak. Questo potrebbe comportare la configurazione delle chiavi API e l'aggiustamento delle impostazioni per adattarsi al tuo ambiente.
4. Integrazione: Integra con client come Claude Desktop per iniziare ad automatizzare i compiti di gestione degli utenti.
5. Utilizzo: Sfrutta le funzionalità dell'MCP per gestire utenti e regni in modo efficiente. Esplora la documentazione per istruzioni dettagliate sull'uso e esempi.

Domande Frequenti

D1: Qual è lo scopo principale del Protocollo di Contesto del Modello Keycloak?

R1: Lo scopo principale dell'MCP è migliorare la gestione degli utenti e l'amministrazione dei regni in Keycloak attraverso l'automazione potenziata dall'IA.

D2: Il Protocollo di Contesto del Modello Keycloak è gratuito da usare?

R2: Sì, l'MCP è un progetto open-source disponibile gratuitamente. Puoi contribuire al suo sviluppo o utilizzarlo nei tuoi progetti senza alcun costo.

D3: Come posso contribuire al Protocollo di Contesto del Modello Keycloak?

R3: Puoi contribuire facendo un fork del repository, apportando miglioramenti e inviando una pull request. La comunità accoglie con favore i contributi che migliorano la funzionalità e l'usabilità dell'MCP.

D4: Posso integrare il Protocollo di Contesto del Modello Keycloak con altre applicazioni?

R4: Sì, l'MCP è progettato per integrarsi con varie applicazioni e client, rendendolo versatile per diversi casi d'uso nella gestione degli utenti.

D5: Dove posso trovare ulteriori informazioni sul Protocollo di Contesto del Modello Keycloak?

R5: Ulteriori informazioni, inclusa la documentazione e esempi di utilizzo, possono essere trovate nel repository GitHub del progetto.

Keycloak MCP Server

A Model Context Protocol server for Keycloak administration, providing tools to manage users and realms.

Features

• Create new users in specific realms
• Delete users from realms
• List available realms
• List users in specific realms

Installation

Installing via Smithery

To install Keycloak for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install keycloak-model-context-protocol --client claude

Via NPM (Recommended)

The server is available as an NPM package:

### Direct usage with npx
npx -y keycloak-model-context-protocol

### Or global installation
npm install -g keycloak-model-context-protocol

Local Development Setup

If you want to develop or modify the server:

git clone <repository-url>
cd keycloak-model-context-protocol
npm install
npm run build

Configuration

Using NPM Package (Recommended)

Configure the server in your Claude Desktop configuration file:

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

For Local Development

{
  "mcpServers": {
    "keycloak": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "admin",
        "KEYCLOAK_ADMIN_PASSWORD": "admin"
      }
    }
  }
}

Available Tools

create-user

Creates a new user in a specified realm.

Inputs:

• realm: The realm name
• username: Username for the new user
• email: Email address for the user
• firstName: User's first name
• lastName: User's last name

delete-user

Deletes a user from a specified realm.

Inputs:

• realm: The realm name
• userId: The ID of the user to delete

list-realms

Lists all available realms.

list-users

Lists all users in a specified realm.

Inputs:

• realm: The realm name

Development

npm run watch

Testing

To test the server using MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y keycloak-model-context-protocol

Deployment

NPM Package

This project is automatically published to NPM via GitHub Actions when a new release is published on GitHub.

Setup Requirements for Deployment

1. Create NPM account and get access token
2. Add NPM_TOKEN secret to GitHub repository
   • Go to repository Settings > Secrets
   • Add new secret named NPM_TOKEN
   • Paste your NPM access token as the value

Prerequisites

• Node.js 18 or higher
• Running Keycloak instance