키클로크 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 에 자동으로 게시됩니다.
배포를 위한 설정 요구 사항
NPM 계정을 생성하고 액세스 토큰을 받으세요
GitHub 저장소에 NPM_TOKEN 비밀 추가
저장소 설정 > 비밀로 이동
NPM_TOKEN이라는 새 비밀을 추가합니다.NPM 액세스 토큰을 값으로 붙여넣습니다.
필수 조건
Node.js 18 이상
Keycloak 인스턴스 실행