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

Related MCP server: User Management MCP Server

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

1. Cree una cuenta NPM y obtenga un token de acceso

2. 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