Keycloak MCP 服务器
Keycloak 管理的模型上下文协议服务器,提供管理用户和领域的工具。
特征
- 在特定领域中创建新用户
- 从领域中删除用户
- 列出可用领域
- 列出特定领域的用户
安装
通过 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
列表领域
列出所有可用的领域。
列表用户
列出指定领域内的所有用户。
输入:
发展
测试
要使用 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 实例