Skip to main content
Glama

키클로크 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 에 자동으로 게시됩니다.

배포를 위한 설정 요구 사항

  1. NPM 계정을 생성하고 액세스 토큰을 받으세요

  2. GitHub 저장소에 NPM_TOKEN 비밀 추가

    • 저장소 설정 > 비밀로 이동

    • NPM_TOKEN 이라는 새 비밀을 추가합니다.

    • NPM 액세스 토큰을 값으로 붙여넣습니다.

필수 조건

  • Node.js 18 이상

  • Keycloak 인스턴스 실행

Available Tools

4 tools
create-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

    B3.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A 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.
      9
      102 npm
      13
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server for Keycloak Admin REST API, enabling user, group, event, and security management through service account authentication.
      33
      152 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that provides a natural language interface for managing Keycloak identity and access management through its REST API.
      MIT

    Appeared in Searches