Keycloak MCP Server

This Keycloak MCP (Model Context Protocol) server streamlines Keycloak administration by providing tools for managing users and realms. It's designed to integrate with Claude Desktop, offering functionalities such as creating and deleting users, listing available realms, and retrieving users within specific realms.

Features

• Create new users in specific realms, specifying details like username, email, and names.
• Delete users from realms using the user ID.
• List all available realms within the Keycloak instance.
• List users in specific realms.

Installation

Installation is possible via Smithery, NPM, or local development setup. NPM is the recommended approach.

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

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

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

Configuration

Configuration involves setting up the server within your Claude Desktop configuration file, specifying the command to execute the server and environment variables for Keycloak URL and admin credentials.

Deployment

The project is automatically published to NPM via GitHub Actions upon release. Requires an NPM account and setting up an NPM_TOKEN secret in the GitHub repository.

Prerequisites

• Node.js 18 or higher
• Running Keycloak instance