Keycloak MCP Server

Keycloak MCP Server

site icon
2025.02.10 19
TypeScriptKeycloak管理用户管理其它
Keycloak MCP Server 是一个用于 Keycloak 管理的模型上下文协议服务器,提供管理用户和领域的工具。其主要功能包括在特定领域创建新用户、删除用户、列出可用领域以及列出特定领域的用户。适用于需要集成 Keycloak 用户管理功能的场景。
View on GitHub

Overview

基本能力

产品定位

Keycloak MCP Server 是一个用于 Keycloak 管理的模型上下文协议服务器,专注于提供用户和领域管理功能。

核心功能

  • 在特定领域创建新用户
  • 从领域删除用户
  • 列出可用领域
  • 列出特定领域的用户

适用场景

  • 需要集成 Keycloak 用户管理功能的系统
  • 自动化 Keycloak 用户管理的场景
  • 需要批量操作 Keycloak 用户的场景

工具列表

  1. create-user: 在指定领域创建新用户
  2. 输入: realm(领域名), username(用户名), email(邮箱), firstName(名), lastName(姓)
  3. delete-user: 从指定领域删除用户
  4. 输入: realm(领域名), userId(用户ID)
  5. list-realms: 列出所有可用领域
  6. list-users: 列出指定领域的所有用户
  7. 输入: realm(领域名)

常见问题解答

  • 需要 Node.js 18 或更高版本
  • 需要运行 Keycloak 实例

使用教程

使用依赖

  • Node.js 18 或更高版本
  • 运行中的 Keycloak 实例

安装教程

通过 Smithery 安装

npx -y @smithery/cli install keycloak-model-context-protocol --client claude

通过 NPM 安装

# 直接使用 npx
npx -y keycloak-model-context-protocol

# 或全局安装
npm install -g keycloak-model-context-protocol

本地开发设置

git clone <repository-url>
cd keycloak-model-context-protocol
npm install
npm run build

调试方式

使用 MCP Inspector 测试服务器:

npx -y @modelcontextprotocol/inspector npx -y keycloak-model-context-protocol

许可证

None