Keycloak MCP Server

🚀 Keycloak MCP サーバー

Keycloak MCP サーバーは、Quarkus フレームワークを利用して実行される Model-Context Protocol (MCP) サービスです。このプロジェクトは Keycloak と統合し、強力で拡張性の高い認証およびアクセス制御ソリューションを提供することを目的としています。

🚀 クイックスタート

ローカルで Keycloak インスタンスを起動するには、以下のコマンドを実行します。

docker-compose -f deploy/docker-compose.yml up

開発モードでの実行

実時コード更新を有効にして、アプリケーションを開発モードで実行するには、以下のコマンドを使用します。

./mvnw quarkus:dev

アプリケーションをビルドするには、以下のコマンドを実行します。

./mvnw package

Goose との統合

このプロジェクトを拡張機能として Goose と統合して実行するには、以下のコマンドを使用します。

goose session --with-extension="java -jar target/keycloak-mcp-server-1.0.0-SNAPSHOT-runner.jar"

以下は、よくある質問とその回答の例です。

( O)> Keycloak で新しいユーザーを作成できますか？
はい、Keycloak で新しいユーザーを作成できます。そのためには、以下のユーザー情報を提供する必要があります。

- **ドメイン**: ユーザーが属するドメイン名。
- **ユーザー名**: ユーザーのユーザー名。
- **FirstName**: ユーザーの名前。
- **LastName**: ユーザーの姓。
- **メールアドレス**: ユーザーのメールアドレス。
- **パスワード**: ユーザーアカウントのパスワード。

これらの詳細情報を提供すれば、ユーザーの作成を支援します。

----
( O)> quarkus ドメイン内のすべてのユーザーをリストアップしてください
以下は「quarkus」ドメイン内のユーザーです。

1. **admin**
   - ID: `af134cab-f41c-4675-b141-205f975db679`

2. **alice**
   - ID: `eb4123a3-b722-4798-9af5-8957f823657a`

3. **jdoe**
   - ID: `1eed6a8e-a853-4597-b4c6-c4c2533546a0`

----
( O)> quarkus ドメイン内のユーザー sshaaf を削除できますか？

✨ 主な機能

• Quarkus フレームワーク: Quarkus フレームワークを使用して構築され、高速な起動時間と低メモリ使用量を実現します。
• MCP 標準: Model-Context Protocol 標準を実装し、効率的な標準入力/出力サーバー操作を可能にします。
• Keycloak 統合: Keycloak とスムーズに統合し、認証と承認に利用します。

📦 インストール

前提条件

• Java 21 以上: システムに Java がインストールされていることを確認してください。
• Maven: プロジェクトの構築と実行に使用します。

📚 ドキュメント

• Quarkus ドキュメント
• Keycloak ドキュメント
• MCP サーバーガイド

🤝 貢献

貢献を歓迎します！詳細については、貢献ガイドを参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。