用途
Keycloak MCP Server 是一个面向 Keycloak 管理的 Model Context Protocol(MCP)服务器,主要用于通过 MCP 协议实现由 AI 驱动的 Keycloak 用户和领域(realm)管理。它能够与 Claude Desktop 及其他 MCP 客户端无缝集成,用于自动化用户操作。
主要能力
该服务器提供的工具包括:
- 在指定 realm 中创建新用户。参数:realm(领域名称)、username(新用户的用户名)、email(用户的电子邮件地址)、firstName(用户的名字)、lastName(用户的姓氏)。
- 从指定 realm 中删除用户。参数:realm、userId(要删除的用户的 ID)。
- 列出所有可用的领域(realms)。
- 列出指定 realm 中的所有用户。
使用方式
安装方式包括:
- 通过 Smithery 为 Claude Desktop 自动安装。
- 通过 NPM(推荐),服务器以 NPM 包形式提供。
- 本地开发设置,如果希望开发或修改该服务器,可使用 NPM 包(推荐)方式,并在 Claude Desktop 配置文件中配置该服务器;也可用于本地开发。
测试服务器时可使用 MCP Inspector。
项目通过 GitHub Actions 在 GitHub 上发布新版本时自动发布到 NPM。发布流程涉及:创建 NPM 账号并获取访问令牌;在 GitHub 仓库的 Settings > Secrets 中添加名为 NPM_TOKEN 的密钥,并将 NPM 访问令牌粘贴为其值。
适用场景
适用于需要通过 AI 客户端(如 Claude Desktop)对 Keycloak 中的用户和领域进行自动化管理的场景,例如创建用户、删除用户、查询领域列表与用户列表等日常管理操作。
限制与要求
运行环境要求 Node.js 18 或更高版本,并需要一个运行中的 Keycloak 实例。除上述已列出的创建用户、删除用户、列出领域、列出用户等工具外,其余功能、收费与价格信息暂未提供。