A Keycloak示例 - 使用Quarkus构建我的首个MCP服务器工具

1
2
3
4
5

<dependency>
    <groupId>io.quarkiverse.mcp</groupId>
    <artifactId>quarkus-mcp-server-stdio</artifactId>
    <version>1.0.0.Alpha5</version>
</dependency>

1
2
3
4

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-keycloak-admin-rest-client</artifactId>
</dependency>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

@ApplicationScoped // [1]
public class UserService {
    
    @Inject 
    Keycloak keycloak; // [2]

    public List<UserRepresentation> getUsers(String realm) {
        return keycloak.realm(realm).users().list();
    }

    public String addUser(String realm, String username, String firstName, 
                         String lastName, String email, String password) {
        UserRepresentation user = new UserRepresentation();
        user.setFirstName(firstName);
        user.setLastName(lastName);
        user.setUsername(username);
        user.setEnabled(true);
        user.setEmail(email);

        CredentialRepresentation credential = new CredentialRepresentation();
        credential.setType(CredentialRepresentation.PASSWORD);
        credential.setValue(password);
        credential.setTemporary(false);
        user.setCredentials(List.of(credential));
        
        Response response = keycloak.realm(realm).users().create(user);
        if (response.getStatus() == Response.Status.CREATED.getStatusCode()) {
            return "Successfully created user: " + username;
        } else {
            Log.error("Failed to create user. Status: " + response.getStatus());
            response.close();
            return "Error creating user: "+" "+username;
        }
    }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

public class UserTool {

    @Inject
    UserService userService;

    @Inject
    ObjectMapper mapper;

    @Tool(description = "Get all users from a keycloak realm")
    String getUsers(@ToolArg(description = "A String denoting the name of the realm where the users reside") String realm) {
        try {
            return mapper.writeValueAsString(userService.getUsers(realm));
        } catch (Exception e) {
            throw new ToolCallException("Failed to get users from realm");
        }
    }

    @Tool(description = "Create a new user in keycloak realm with the following mandatory fields realm, username, firstName, lastName, email, password")
    String addUser(@ToolArg(description = "A String denoting the name of the realm where the user resides") String realm,
                   @ToolArg(description = "A String denoting the username of the user to be created") String username,
                   @ToolArg(description = "A String denoting the first name of the user to be created") String firstName,
                   @ToolArg(description = "A String denoting the last name of the user to be created") String lastName,
                   @ToolArg(description = "A String denoting the email of the user to be created") String email,
                   @ToolArg(description = "A String denoting the password of the user to be created") String password) {
        return userService.addUser(realm, username, firstName, lastName, email, password);
    }
}

1
2
3

quarkus.package.jar.type=uber-jar
quarkus.log.file.enable=true
quarkus.log.file.path=kcadmin-quarkus.log

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

( O)> can I create a new user in keycloak?
是的，您可以在Keycloak中创建新用户。为此，您需要提供以下用户信息：
- Realm：用户将驻留的Realm名称
- Username：新用户的用户名
- First Name：用户的名字
- Last Name：用户的姓氏
- Email：用户的电子邮件地址
- Password：用户帐户的密码

您可以提供这些详细信息，我可以协助您创建用户。

----
( O)> list all users in all realms
以下是"quarkus" realm中的用户：
1. admin - ID: af134cab-f41c-4675-b141-205f975db679
2. alice - ID: eb4123a3-b722-4798-9af5-8957f823657a
3. jdoe - ID: 1eed6a8e-a853-4597-b4c6-c4c2533546a0

----
( O)> can you delete user sshaaf from realm quarkus