Keycloak MCP Server (Christoph Englisch)

Keycloak MCP服务器

](https://smithery.ai/server/keycloak-model-context-protocol)

用于Keycloak管理的模型上下文协议服务器，提供管理用户和领域的工具。

特性

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面的Keycloak 史密瑟里:

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

通过NPM（推荐）

服务器可作为NPM包使用：

# Direct usage with npx
npx -y keycloak-model-context-protocol

# Or global installation
npm install -g keycloak-model-context-protocol

地方发展设置

如果要开发或修改服务器：

git clone 
cd keycloak-model-context-protocol
npm install
npm run build

配置

使用NPM包（推荐）

在Claude Desktop配置文件中配置服务器：

{
  "mcpServers": {
    "keycloak": {
      "command": "npx",
      "args": ["-y", "keycloak-model-context-protocol"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "admin",
        "KEYCLOAK_ADMIN_PASSWORD": "admin"
      }
    }
  }
}

促进地方发展

{
  "mcpServers": {
    "keycloak": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "KEYCLOAK_URL": "http://localhost:8080",
        "KEYCLOAK_ADMIN": "admin",
        "KEYCLOAK_ADMIN_PASSWORD": "admin"
      }
    }
  }
}

可用工具

创建用户

在指定领域中创建新用户。

输入:

• realm：领域名称
• username：新用户的用户名
• email：用户的电子邮件地址
• firstName：用户的名字
• lastName：用户的姓氏

删除用户

从指定领域删除用户。

输入:

• realm：领域名称
• userId：要删除的用户的ID

列出领域

列出所有可用领域。

列出用户

列出指定领域中的所有用户。

输入:

• realm：领域名称

发展

npm run watch

测试

要使用MCP检查器测试服务器，请执行以下操作：

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

部署

NPM包

此项目将自动发布到 在GitHub上发布新版本时，通过GitHub Actions。

部署设置要求

1. 创建NPM帐户并获取访问令牌
2. 将NPM_TOKEN secret添加到GitHub存储库

- 转到存储库设置>机密 - 添加名为的新密钥 NPM_TOKEN - 将您的NPM访问令牌粘贴为值

先决条件

• Node.js 18或更高版本
• 正在运行Keycloak实例