Keycloak MCP Server
키클로크 MCP 서버
Keycloak 관리를 위한 모델 컨텍스트 프로토콜 서버로, 사용자와 영역을 관리하는 도구를 제공합니다.
특징
특정 영역에서 새로운 사용자 생성
영역에서 사용자 삭제
사용 가능한 영역 나열
특정 영역의 사용자 목록
Related MCP server: User Management MCP Server
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 Keycloak을 자동으로 설치하려면:
지엑스피1
NPM을 통해(권장)
이 서버는 NPM 패키지로 제공됩니다.
# Direct usage with npx
npx -y keycloak-model-context-protocol
# Or global installation
npm install -g keycloak-model-context-protocol지역 개발 설정
서버를 개발하거나 수정하려면:
git clone <repository-url>
cd keycloak-model-context-protocol
npm install
npm run build구성
NPM 패키지 사용(권장)
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"
}
}
}
}지역 개발을 위해
{
"mcpServers": {
"keycloak": {
"command": "node",
"args": ["path/to/dist/index.js"],
"env": {
"KEYCLOAK_URL": "http://localhost:8080",
"KEYCLOAK_ADMIN": "admin",
"KEYCLOAK_ADMIN_PASSWORD": "admin"
}
}
}
}사용 가능한 도구
사용자 생성
지정된 영역에 새로운 사용자를 만듭니다.
입력 :
realm: 영역 이름username: 새 사용자의 사용자 이름email: 사용자의 이메일 주소firstName: 사용자의 이름lastName: 사용자의 성
사용자 삭제
지정된 영역에서 사용자를 삭제합니다.
입력 :
realm: 영역 이름userId: 삭제할 사용자의 ID
목록 영역
사용 가능한 모든 영역을 나열합니다.
사용자 목록
지정된 영역에 있는 모든 사용자를 나열합니다.
입력 :
realm: 영역 이름
개발
npm run watch테스트
MCP Inspector를 사용하여 서버를 테스트하려면:
npx -y @modelcontextprotocol/inspector npx -y keycloak-model-context-protocol전개
NPM 패키지
GitHub에 새로운 릴리스가 게시되면 이 프로젝트는 GitHub Actions를 통해 NPM 에 자동으로 게시됩니다.
배포를 위한 설정 요구 사항
NPM 계정을 생성하고 액세스 토큰을 받으세요
GitHub 저장소에 NPM_TOKEN 비밀 추가
저장소 설정 > 비밀로 이동
NPM_TOKEN이라는 새 비밀을 추가합니다.NPM 액세스 토큰을 값으로 붙여넣습니다.
필수 조건
Node.js 18 이상
Keycloak 인스턴스 실행
Available Tools
4 toolscreate-userC
Create a new user in a specific realm
Inputs: realm (required), username (required), email (required), firstName (required), +1 more.
delete-userC
Delete a user from a specific realm
Inputs: realm (required), userId (required).
list-realmsB
List all available realms
Inputs: no named parameters.
list-usersC
List users in a specific realm
Inputs: realm (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose with no overlap: create-user and delete-user handle user lifecycle actions, list-realms lists realms, and list-users lists users within a realm. The descriptions make it unambiguous which tool to use for each operation.
All tool names follow a consistent verb_noun pattern with hyphen separation (e.g., create-user, delete-user, list-realms, list-users). This uniformity makes the tool set predictable and easy to understand.
With only 4 tools, the set feels thin for a Keycloak server, which typically manages realms, users, roles, clients, and groups. While the tools cover basic user and realm operations, the scope is limited compared to the domain's complexity.
There are significant gaps in the tool surface for Keycloak management. Missing operations include updating users, managing roles, handling clients, and performing authentication flows. This incomplete coverage will likely cause agent failures when trying to perform common administrative tasks.
Maintenance
Related MCP Connectors
Managed Keycloak from any MCP client: clusters, realms, apps, SSO, users, domains, audit events.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables management of Keycloak users and realms through a standardized interface, providing tools for user creation, deletion, role assignment, and group management.9102 npm13MIT
- AlicenseCqualityDmaintenanceA Model Context Protocol server demonstrating user management capabilities with tools for creating, retrieving, and generating random user data.2ISC
- AlicenseAqualityBmaintenanceAn MCP server for Keycloak Admin REST API, enabling user, group, event, and security management through service account authentication.33152 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides a natural language interface for managing Keycloak identity and access management through its REST API.MIT