Keycloak Realm Inspector
Keycloak Realm Inspector
KeyConf 2026のClient ID Metadata Documents(draft-ietf-oauth-client-id-metadata-document-02)に関するトークのための、純粋にOAuth 2.0保護リソースであるMCPサーバー。
何も発行しません — /authorizeも/tokenもクライアントシークレットもありません。Keycloakがトークンを発行します。このサーバーはKeycloakのJWKSに対してトークンを検証し、RFC 9728ディスカバリーを提供し、リソースサーバーの内部からCIMDを可視化する3つのツールを公開します。
意図的に分離された三者
Keycloak | 認可サーバー。 |
MCPクライアント | 自身が制御するURLでメタデータドキュメントを公開します。そのURLがそのまま |
このサーバー | 保護リソース。ポート9001 |
このサーバーはクライアントのメタデータドキュメントをホストせず、読み取らず、フェッチもしません。/client-metadata.jsonルートもローカルコピーもありません。Keycloakは/authorize中にそのURLをネットワーク経由でフェッチします。このコードベースでは、URLはazpクレームに含まれる不透明な文字列としてのみ現れます — それがデモの要点であり、ドキュメントが別のポートの別プロセスで提供される理由でもあります。
Related MCP server: Akeyless MCP Interop (OpenID AIIM)
実行
Keycloakが起動しており、レルムが作成され、CIMDクライアントポリシーがすでに適用されていることを前提としています。クライアント、そのメタデータドキュメント、トークンヘルパーは、このリポジトリと同じ階層の../cimd-demo/auth-server/にあります。
# terminal 1 — the client's document. Its own party, its own port.
cd ../cimd-demo/auth-server && python -m http.server 9000
# terminal 2 — the resource server
pip install -r requirements.txt
python server.py # http://localhost:9001
# terminal 3 — get a token, then point an MCP client at :9001/mcp
cd ../cimd-demo/auth-server && python get-token.pyフロー
クライアントはトークンなしで
/mcpを呼び出し、WWW-Authenticate: Bearer ..., resource_metadata="…"付きの401を受け取ります。クライアントはそれに従って
/.well-known/oauth-protected-resource/mcpにアクセスし、どの認可サーバーが有効なトークンを発行するかを学習します。クライアントはメタデータドキュメントのURLを
client_idとして使用して、Keycloakに対して直接認証します。KeycloakはそのURLをフェッチしてクライアントを実体化します。クライアントはベアラートークンで
/mcpを再試行します。
RFC 9728 §3.1はwell-knownセグメントをホストとリソースパスの間に置くため、ディスカバリードキュメントは/.well-known/oauth-protected-resource/mcpにあります。素のパスは404です。
ツール
whoami()— 呼び出し元のトークンからのsub、preferred_username、azp、scope、exp、issに加えて、registered_via_cimd。トークンのみを読み取ります。Keycloakへの呼び出しがないため、管理者の認証情報が間違っていても機能します。list_clients(only_cimd=False)— レルムのクライアント。URL形式のclient_idを先頭にソートして、呼び出し元のクライアントが最初の行に来るようにします。get_client_metadata(client_id)— Keycloak自身によるクライアントの表現。これはKeycloakの派生ビューであり、公開されたドキュメントではありません。
CIMDはhttp://またはhttps://で始まるclient_idによって検出されます。URL形式のclient_idがその目印です。
get_client_metadataは、返す前にsecretとregistrationAccessTokenを除去します。どちらも有効なベアラー資格情報であり、この出力はプロジェクターに映され、録画にも入ります。
既知のギャップが2つ
RFC 8707リソースインジケーター。 audience=は存在しますが、JWTVerifierではコメントアウトされています。トークンをオーディエンス制限するには、クライアントが/authorizeでresourceを送信する必要がありますが、Keycloak 26.7のCIMDパスはまだそれを尊重していません(keycloak#45106、keycloak#45284)。そのため、トークンはKeycloakの通常のaccountオーディエンスを保持し、このサーバーはオーディエンス制限できません。意図的に見えるようにしています。
スコープ強制なし。 required_scopesが未設定のため、レルムからの署名が有効で有効期限が切れていないトークンはすべて受け入れられます — admin-cliパスワードグラントからのトークンも含みます。これはステージで役立ちます:管理者トークン(azpは不透明な文字列)でwhoami()を実行し、CIMDトークン(azpはURL)でもう一度実行します。同じツール、同じサーバー、違いは1つのフィールドだけです。これはまた、手にしているトークンがどれかを確実に把握している必要があることも意味します。
設定
すべてos.getenvで、localhostをデフォルトとしています。
変数 | デフォルト |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
KEYCLOAK_ISSUERとKEYCLOAK_JWKS_URIは互いに導出されるのではなく、個別に設定可能です:KubernetesではイシュアーがパブリックURLであるため、issはクライアントが見るものと一致しますが、JWKSフェッチはクラスター内のServiceに向けるべきです。
fastmcpは正確に固定されています。認証サーフェスは移り変わります — resource_server_urlはbase_urlになり、AccessToken.claimsは2.11.3で追加されました — そしてallowed_client_redirect_urisは、ドキュメントが示しているにもかかわらず、どのリリースでもRemoteAuthProviderのパラメーターではありません。これは、このサーバーが使用しないOAuthProxyに属します。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Managed Keycloak from any MCP client: clusters, realms, apps, SSO, users, domains, audit events.
Remote MCP for A2A caller identity, scope policy, verdict receipts, and audit history.
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
OAuth scope approvals and consent receipts for remote MCP servers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceDemonstrates MCP remote authentication boundary with OAuth 2.0, Keycloak token introspection, audience and scope validation, and protected tools.1-
- AlicenseNot gradedqualityDmaintenanceImplements an MCP server with OAuth 2.1 Protected Resource Metadata, enabling token-based authentication for MCP tools like ping.MIT
- AlicenseAqualityBmaintenanceEnables MCP-capable clients to inspect and manage Keycloak realms, users, clients, roles, and groups with layered security modes, realm allowlisting, protected realms, delete gating, dry-run, and audit logging.855 npm1MIT
- FlicenseBqualityBmaintenanceEnables MCP clients to authenticate through OIDC and call protected tools while rejecting unauthenticated requests.26-