Keycloak 用の MCP サーバー

Keycloak MCP サーバー

Keycloak管理機能へのプログラム的なアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。

概要

Keycloak MCP Server は、モデルコンテキストプロトコルを介して Keycloak とやり取りする AI アシスタントと開発ツールを可能にします。 ユーザー管理、リアルタイム設定、クライアント管理、認証フロー管理など、包括的なKeycloak操作をサポートします。

主な特長

• ユーザーJWTトークン認証 *広範囲のKeycloak操作(ユーザー、実体、顧客、役割、グループ、等)
• HTTP ベースの通信のための SSE 輸送
• 生産準備完了 OpenShift/Kubernetes展開 *マルチアーキテクチャコンテナイメージ
• GraalVMネイティブイメージサポート

クイックスタート

Docker の使用

##認証

ユーザーは、Keycloakから独自のJWTトークンを認証します。

MCP クライアント ([~/.cursor/mcp.json]) で構成します。

ドキュメント

docs ディレクトリに完全なドキュメントが使用可能です。

• 入門ガイド - セットアップ手順 *認証ガイド - ユーザー認証
• OpenShiftの展開 - 生産展開
• 開発者ガイド - 開発ガイド

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