SuperAPI AI 工具集

keycloak-model-context-protocol

Keycloak MCP Server 是一个用于 Keycloak 用户管理的 Model Context Protocol(MCP)服务器实现,允许通过 MCP 协议以 AI 驱动的方式管理 Keycloak 用户与领域(realm)。项目可无缝集成 Claude Desktop 及其他 MCP 客户端,实现自动化用户操作。其提供的主要工具包括:在指定 realm 中创建新用户、从 realm 中删除用户、列出所有可用的 realm、列出指定 realm 中的用户。项目可通过 Smithery 为 Claude Desktop 自动安装,也提供了 NPM 包(推荐方式)。项目要求 Node.js 18 或更高版本,并需要有一个运行中的 Keycloak 实例。

访问官网

工具介绍

用途

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 实例。除上述已列出的创建用户、删除用户、列出领域、列出用户等工具外,其余功能、收费与价格信息暂未提供。