Keycloak MCP Server

Keycloak MCP Server

site icon
2025.04.03 1
Java身份管理访问控制其它
Keycloak MCP Server 是一个基于 Quarkus 框架的服务,用于实现 Model-Context Protocol (MCP) 服务器功能。该项目与 Keycloak 集成,提供身份和访问管理解决方案,具有快速启动和低内存占用的特点。
View on GitHub

Overview

基本能力

产品定位

Keycloak MCP Server 是一个基于 Quarkus 框架的 MCP 服务器,专注于与 Keycloak 集成,提供身份和访问管理功能。

核心功能

  • Quarkus 框架:提供快速启动和低内存占用的优势。
  • MCP 标准:实现 Model-Context Protocol,支持高效的输入/输出服务器操作。
  • Keycloak 集成:无缝集成 Keycloak,用于认证和授权。

适用场景

  • 需要与 Keycloak 集成的身份和访问管理解决方案。
  • 需要快速启动和低内存占用的服务器应用。

工具列表

  • Maven:用于构建和运行项目。
  • Docker Compose:用于启动本地 Keycloak 实例。
  • Goose:用于集成和运行项目作为扩展。

常见问题解答

  • 如何创建新用户:需要提供 Realm、Username、First Name、Last Name、Email 和 Password 信息。
  • 如何列出用户:可以列出指定 Realm 中的所有用户。
  • 如何删除用户:可以删除指定 Realm 中的用户。

使用教程

使用依赖

  • Java 21 或更新版本:确保系统已安装 Java。
  • Maven:用于构建和运行项目。

安装教程

  1. 启动本地 Keycloak 实例:
docker-compose -f deploy/docker-compose.yml up
  1. 在开发模式下运行应用:
./mvnw quarkus:dev
  1. 打包应用:
./mvnw package
  1. 使用 Goose 运行:
goose session --with-extension="java -jar target/keycloak-mcp-server-1.0.0-SNAPSHOT-runner.jar"

调试方式

  • 在开发模式下运行应用时,支持实时编码。
  • 使用 Maven 命令进行构建和打包。

许可证

该项目遵循 MIT 开源许可条款。