Keycloak MCP сервер

MCP сервер для администрирования Keycloak, предоставляющий инструменты для управления пользователями и реалмами через взаимодействие на естественном языке.

Установка

Smithery

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

NPX

npx -y keycloak-model-context-protocol

NPM Global

npm install -g keycloak-model-context-protocol

Из исходников

git clone <repository-url>
cd keycloak-model-context-protocol
npm install
npm run build

Конфигурация

Claude Desktop (NPM пакет)

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

Claude Desktop (локальная разработка)

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

Доступные инструменты

Инструмент	Описание
`create-user`	Создает нового пользователя в указанном реалме с именем пользователя, email, именем и фамилией
`delete-user`	Удаляет пользователя из указанного реалма по его ID
`list-realms`	Отображает список всех доступных реалмов в экземпляре Keycloak
`list-users`	Отображает список всех пользователей в указанном реалме

Возможности

Создание новых пользователей в определенных реалмах
Удаление пользователей из реалмов
Просмотр доступных реалмов
Просмотр пользователей в определенных реалмах

Переменные окружения

Обязательные

KEYCLOAK_URL - URL экземпляра Keycloak
KEYCLOAK_ADMIN - Имя пользователя администратора для аутентификации в Keycloak
KEYCLOAK_ADMIN_PASSWORD - Пароль администратора для аутентификации в Keycloak

Ресурсы

GitHub Repository

Примечания

Требует Node.js 18 или выше и работающий экземпляр Keycloak. Проект автоматически публикуется в NPM через GitHub Actions. Для тестирования используйте MCP Inspector с командой: npx -y @modelcontextprotocol/inspector npx -y keycloak-model-context-protocol