Keycloak MCP 服务器
Keycloak 管理的模型上下文协议服务器，提供管理用户和领域的工具。
特征
在特定领域中创建新用户
从领域中删除用户
列出可用领域
列出特定领域的用户
Related MCP server: MetaMask MCP
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 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 <repository-url>
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 Inspector 测试服务器：
npx -y @modelcontextprotocol/inspector npx -y keycloak-model-context-protocol
部署
NPM 包
当 GitHub 上发布新版本时，该项目将通过 GitHub Actions 自动发布到NPM 。
部署设置要求
创建 NPM 帐户并获取访问令牌
将 NPM_TOKEN 密钥添加到 GitHub 存储库
转到存储库设置> Secrets
添加名为
NPM_TOKEN的新机密粘贴您的 NPM 访问令牌作为值
先决条件
Node.js 18 或更高版本
运行 Keycloak 实例