Another Keycloak MCP

MCP安全风控

提供方 aelkz

安全风控 未标注 无需鉴权 社区 / 第三方 Claude

AKC-MCP是一个全面的Keycloak身份和访问管理协议服务器,提供高级用户管理功能和内置安全特性。

一句话选型结论

按资料字段整理

Another Keycloak MCP 属于安全风控类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 45 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量45暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

身份管理TypeScript本地部署用户管理安全协议Keycloak扩展自动化工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 45 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 45 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Another Keycloak MCP当前 45 未标注 未标注 无 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方aelkz上游标注的维护方 aelkz
分类安全风控本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.8 KB
来自项目仓库与上游目录的原文,未做删改

AKC-MCP(另一款钥匙斗篷MCP)

Keycloak IAM的综合模型上下文协议(MCP)服务器,具有高级用户管理功能和内置安全功能。

> 有关安装和设置说明,请参阅 设置.md


概述

AKC-MCP为Keycloak提供了一个完整的MCP接口,使Claude等AI助手能够安全有效地管理身份和访问管理操作。它使用TypeScript和官方Keycloak管理客户端构建,提供 45工具 跨用户管理、组管理、领域操作、身份验证流和客户端范围。

主要特点

  • 🔍 高级用户搜索:多字段搜索,精确/模糊匹配,重复检测,IDP链接检查
  • 👥 集团综合管理:具有属性管理、层次导航和布尔标志的完整CRUD
  • 🌐 领域操作:导出、统计、SAML证书监控、自定义SPI检测
  • 🔐 认证管理:流量检查、所需操作、配置分析
  • 🎯 客户范围管理:OIDC和SAML作用域的完整CRUD操作
  • 🛡️ 安全功能:开发/生产模式、只读模式、操作警告
  • 📝 类型安全:带Zod运行时验证的完整TypeScript
  • 🔌 双重运输:支持Stdio(MCP)和HTTP/SSE

设计用于

  • Keycloak管理员和DevOps团队
  • 身份和访问管理自动化
  • 批量用户操作和审计
  • 领域配置管理
  • 安全合规性监控
  • 开发和测试工作流程

可用工具(共45个)

用户管理(13个工具)

高级用户查找和管理以及安全检查。

工具 说明
搜索用户 多字段搜索(用户名、电子邮件、名字、姓氏),精确/模糊匹配
获取用户详细信息 完整的用户配置文件,包括属性、组和IDP链接
检查多个帐户 查找共享同一电子邮件的多个用户帐户
检查用户idp代理链接 检查用户是否链接到身份提供者(代理链接)
获取用户idp链接 列出用户的所有身份提供程序连接
列出用户属性 获取用户的所有自定义属性
列出用户会话 查看活动用户会话
创建用户 使用可选的临时密码创建新用户
更新用户 修改用户信息
删除用户 删除用户(带有警告的破坏性操作)
重置密码 重置用户密码(临时或永久)
切换用户状态 启用或禁用用户帐户
列出用户 使用分页列出域中的所有用户

集团管理(16种工具)

具有属性支持的完整组生命周期管理。

工具 说明
列出组 列出所有具有可选搜索筛选的组
获取组 获取详细的组信息
创建组 创建新组或子组
更新组 修改组名或属性
删除组 删除组(破坏性操作)
将用户添加到组 将用户添加到组成员资格
从组中删除用户 从组中删除用户
列出用户组 列出用户所属的所有组
列出组成员 列出特定组中的所有用户
按属性搜索组 按属性键值对搜索组
获取组属性 获取组的所有属性
设置组属性 设置或更新组属性
删除组属性 删除组属性
切换组布尔属性 切换布尔属性(真/假标志)
获取父组 向上导航组层次结构
获取子组 使用可选的递归遍历获取子组

领域操作(6个工具)

领域配置、统计和管理。

工具 说明
列出领域 列出所有可用的Keycloak领域
获取领域 获取详细的领域配置
获取领域统计信息 获取统计数据(用户、组、客户端、会话)
出口领域 使用细粒度选项导出领域配置
检查saml证书 监控SAML证书过期
列出领域spis 列出自定义服务提供商接口

身份验证(3个工具)

身份验证流程和所需操作管理。

工具 说明
列出身份验证流程 列出域中的所有身份验证流
获取身份验证流 获取包括执行在内的流程详细信息
列出所需操作 列出所有必需的操作配置

客户范围(7个工具)

OIDC和SAML客户端范围管理。

工具 说明
列出客户端作用域 列出领域中的所有客户端作用域
获取客户端范围 使用协议映射器获取范围详细信息
创建客户端作用域 创建新的OIDC或SAML作用域
更新客户端范围 修改现有客户端范围
删除客户端作用域 删除客户端作用域(破坏性)
分配客户端范围 为客户端分配范围(默认/可选)
删除客户端作用域 从客户端删除范围分配

安全功能

操作模式

发展模式 (默认)

  • 允许写入操作,但有警告
  • 用于调试的完整错误堆栈跟踪
  • 详细日志记录可用

生产模式```bash
OPERATION_MODE=production


- 写入操作的额外确认
- 增强了对破坏性操作的警告
- 山宁泰错误消息

### 只读模式```bash
READ_ONLY_MODE=true
  • 阻止所有写入操作(创建、更新、删除)
  • 非常适合审计和检查
  • 对生产环境安全
  • 非常适合学习和探索

安全检查

所有写入操作包括:

  • ✅ 操作模式验证
  • ✅ 只读模式强制
  • ✅ 破坏性操作警告
  • ✅ 结构化日志记录
  • ✅ 响应中的安全警告信息

建筑

技术栈

  • 语言:具有严格模式的TypeScript
  • 运行时:Node.js 18+
  • Keycloak客户端:官方 @keycloak/keycloak-admin-client v26.x
  • MCP-SDK: @modelcontextprotocol/sdk
  • 验证:用于运行时类型检查的Zod模式
  • 日志记录:Winston结构化日志
  • 构建:tsup用于高效的ESM捆绑

项目结构```

src/
├── common/ # Server setup, constants
├── config/ # Environment-based configuration
├── schemas/ # Zod validation schemas
├── services/ # Keycloak client wrapper
├── tools/ # MCP tool implementations
│ ├── user-tools.ts (13 tools)
│ ├── group-tools.ts (16 tools)
│ ├── realm-operations.ts (3 tools)
│ ├── realm-tools.ts (3 tools)
│ ├── authentication-tools.ts (3 tools)
│ └── client-scope-tools.ts (7 tools)
├── types/ # TypeScript definitions
├── utils/ # Logger, safety checks
└── index.ts # Main entry point


______________________________________________________________________

## 快速开始

### 先决条件

- Node.js 18+
- Keycloak服务器正在运行(建议使用v26.4.5)
- Keycloak管理员凭据

### 安装```bash
npm install -g another-keycloak-mcp

基本配置```bash

Create .env file

cat > .env << EOF
KEYCLOAK_URL=http://0.0.0.0:8082
KEYCLOAK_REALM=master
KEYCLOAK_ADMIN_USERNAME=admin
KEYCLOAK_ADMIN_PASSWORD=admin
EOF

Run

akc-mcp


**有关完整的设置说明**,请参阅 设置.md

______________________________________________________________________

## 用例

### 用户管理

- 批量用户创建和更新
- 重复电子邮件检测和清理
- 身份提供者链接验证
- 会话监控和管理
- 用户属性审核

### 组管理

- 动态集团组织
- 通过布尔属性进行特征标志管理
- 组层次导航
- 批量会员操作
- 基于属性的组过滤

### 领域操作

- 配置备份和导出
- SAML证书过期监控
- 自定义SPI库存
- 多领域统计数据收集
- 领域配置分析

### 认证

- 流量配置检查
- 所需行动管理
- 身份验证方法审核
- 登录流分析

### 客户范围

- 范围模板管理
- 批量范围分配
- OIDC/SAML配置
- 协议映射器分析

______________________________________________________________________

## 示例用法

### 搜索用户```typescript
{
&quot;tool&quot;: &quot;search-user&quot;,
&quot;arguments&quot;: {
&quot;realm&quot;: &quot;master&quot;,
&quot;email&quot;: &quot;@example.com&quot;,
&quot;exact&quot;: false
}
}

检查身份提供者链接```typescript

{
"tool": "check-user-idp-broker-link",
"arguments": {
"realm": "master",
"userId": "user-id-here",
"identityProvider": "google"
}
}


### 按属性搜索组```typescript
{
&quot;tool&quot;: &quot;search-groups-by-attributes&quot;,
&quot;arguments&quot;: {
&quot;realm&quot;: &quot;master&quot;,
&quot;attributeKey&quot;: &quot;feature_flag&quot;,
&quot;attributeValue&quot;: &quot;true&quot;,
&quot;exact&quot;: true
}
}

导出领域配置```typescript

{
"tool": "export-realm",
"arguments": {
"realm": "master",
"includeUsers": false,
"includeGroups": true,
"includeRoles": true,
"includeClients": true
}
}


### 监控SAML证书```typescript
{
&quot;tool&quot;: &quot;check-saml-certificates&quot;,
&quot;arguments&quot;: {
&quot;realm&quot;: &quot;production&quot;,
&quot;warnDays&quot;: 30
}
}

文档

  • 设置.md -安装、配置和部署

版本兼容性

  • 钥匙斗篷:使用版本26.4.5进行测试
  • Node.js:需要版本18或更高版本
  • MCP协议:版本1.0

> 备注:虽然此服务器是为Keycloak 26.4.5设计的,但它可能适用于其他版本。某些功能可能会因版本不匹配而表现不同。


许可证

MIT许可证-请参阅 许可证 详细信息文件


致谢

  • 内置于 模型上下文协议SDK
  • 用途 Keycloak管理客户端
  • 受Keycloak社区和现有MCP实现的启发

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Another Keycloak MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Another Keycloak MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Another Keycloak MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Another Keycloak MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Another Keycloak MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Another Keycloak MCP 能提供哪些能力?

资料显示约 45 个工具;能力标签包括 安全协议、TypeScript、Claude、用户管理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。