키클로크 MCP 서버

Keycloak 관리를 위한 모델 컨텍스트 프로토콜 서버로, 사용자와 영역을 관리하는 도구를 제공합니다.

특징

• 특정 영역에서 새로운 사용자 생성

• 영역에서 사용자 삭제

• 사용 가능한 영역 나열

• 특정 영역의 사용자 목록

Related MCP server: MetaMask MCP

설치

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 인스턴스 실행