Keycloak을 위한 MCP 서버

Keycloak MCP 서버

Keycloak 관리 기능에 대한 programmatic 액세스를 제공하는 모델 Context Protocol (MCP) 서버.

개요

Keycloak MCP Server는 Model Context Protocol을 통해 Keycloak과 상호 작용하는 AI 보조 및 개발 도구를 지원합니다. 그것은 사용자 관리, 영역 구성, 클라이언트 관리 및 인증 흐름 관리를 포함하여 포괄적 인 Keycloak 작업을 지원합니다.

키 기능

• 사용자 JWT 토큰 인증
• 포괄적인 Keycloak 가동 (사용자, realms, 클라이언트, 역할, 그룹, 등)
• HTTP 기반 통신에 대한 SSE 운송
• Production-ready OpenShift/Kubernetes 배포
• Multi-architecture 컨테이너 이미지
• GraalVM 기본 이미지 지원

빠른 시작

Docker 사용

인증

사용자는 Keycloak의 자체 JWT 토큰을 인증합니다.

MCP 클라이언트에서 구성 (~/.cursor/mcp.json):

문서

완전한 문서는 docs 디렉토리에 있습니다.

• 시작 가이드 얻기 - 설정 지침
• 인증 가이드 - 사용자 인증
• OpenShift 배포 - 생산 배치
• 개발자 가이드 - Development Guide

An MCP Server for Keycloak

Keycloak MCP Server

A Model Context Protocol (MCP) server that provides programmatic access to Keycloak administration functionality.

Overview

The Keycloak MCP Server enables AI assistants and development tools to interact with Keycloak through the Model Context Protocol. It supports comprehensive Keycloak operations including user management, realm configuration, client administration, and authentication flow management.

Key Features

• User JWT Token Authentication
• Comprehensive Keycloak Operations (users, realms, clients, roles, groups, etc.)
• SSE Transport for HTTP-based communication
• Production-ready OpenShift/Kubernetes deployment
• Multi-architecture container images
• GraalVM native image support

Quick Start

Using Docker

docker run -d \
  --name keycloak-mcp-server \
  -p 8080:8080 \
  -e KC_URL=https://keycloak.example.com \
  -e KC_REALM=master \
  -e OIDC_CLIENT_ID=mcp-server \
  quay.io/sshaaf/keycloak-mcp-server:latest

Authentication

Users authenticate with their own JWT tokens from Keycloak:

# Get your token
./scripts/get-mcp-token.sh \
  --keycloak-url https://keycloak.example.com \
  --username your-username \
  --password your-password

Configure in your MCP client (~/.cursor/mcp.json):

{
  "mcpServers": {
    "keycloak": {
      "transport": "sse",
      "url": "https://mcp-server.example.com/mcp/sse",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

Documentation

Complete documentation is available in the docs directory:

• Getting Started Guide - Setup instructions
• Authentication Guide - User authentication
• OpenShift Deployment - Production deployment
• Developers Guide - Development guide
• Full Documentation Index - Complete table of contents

Building Documentation

This project uses MkDocs for documentation. To build and serve locally:

pip install mkdocs-material
mkdocs serve

Visit http://localhost:8000 to view the documentation.

Container Images

Pre-built images are available on Quay.io:

docker pull quay.io/sshaaf/keycloak-mcp-server:latest

Images are automatically built and pushed on commits to main and on releases.

Building

JAR

mvn clean package
java -jar target/quarkus-app/quarkus-run.jar

Native Image

mvn clean package -Pnative
./target/keycloak-mcp-server-runner

Container Image

mvn clean package -Dquarkus.container-image.build=true

Tests

• Default unit and integration tests: mvn test
• Prompt / eval coverage notes: evals/README.md

Technology Stack