Servidor MCP de Keycloak

Un servidor de protocolo de contexto modelo para la administración de Keycloak, que proporciona herramientas para gestionar usuarios y reinos.

Características

Crear nuevos usuarios en reinos específicos
Eliminar usuarios de los reinos
Lista de reinos disponibles
Enumerar usuarios en reinos específicos

Instalación

Instalación mediante herrería

Para instalar Keycloak para Claude Desktop automáticamente a través de Smithery :

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

Vía NPM (recomendado)

El servidor está disponible como un paquete NPM:

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

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

Configuración de desarrollo local

Si desea desarrollar o modificar el servidor:

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

Configuración

Uso del paquete NPM (recomendado)

Configure el servidor en su archivo de configuración de Claude Desktop:

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

Para el desarrollo local

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

Herramientas disponibles

crear-usuario

Crea un nuevo usuario en un reino específico.

Entradas :

realm : El nombre del reino
username : nombre de usuario para el nuevo usuario
email : Dirección de correo electrónico del usuario
firstName : Nombre del usuario
lastName : Apellido del usuario

eliminar usuario

Elimina un usuario de un reino específico.

Entradas :

realm : El nombre del reino
userId : El ID del usuario a eliminar

lista-reinos

Enumera todos los reinos disponibles.

lista de usuarios

Enumera todos los usuarios en un reino específico.

Entradas :

realm : El nombre del reino

Desarrollo

npm run watch

Pruebas

Para probar el servidor usando MCP Inspector:

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

Despliegue

Paquete NPM

Este proyecto se publica automáticamente en NPM a través de GitHub Actions cuando se publica una nueva versión en GitHub.

Requisitos de configuración para la implementación

Cree una cuenta NPM y obtenga un token de acceso
Agregar el secreto NPM_TOKEN al repositorio de GitHub
- Vaya a Configuración del repositorio > Secretos
- Agregar nuevo secreto llamado NPM_TOKEN
- Pegue su token de acceso NPM como valor

Prerrequisitos

Node.js 18 o superior
Ejecución de una instancia de Keycloak

Keycloak MCP Server

Integrations