Implement server-side support for Client ID Metadata Documents (CIMD)

Offen

#1,801 erstellt am 18.12.2025 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 5/5
Geschätzter Aufwand: Über eine Woche
Anfängerfreundlichkeit: 35/100

Issue-Typ: Feature
Klarheit: Größtenteils klar
Aktivitätsstatus: Veraltet
Tech-Stack: python
Bereich: api, authentication, backend, security

Rechercherichtung

Beginne mit der Überprüfung der clientseitigen CIMD-Unterstützung in PR #1652 sowie der OAuth-Metadaten des SDK und der serverseitigen Autorisierungsverarbeitung. Ordne die Erkennung des fehlenden URL client_id, das Abrufen von Dokumenten, die Validierung, das Caching und den SSRF-Schutz den vorhandenen Einstiegspunkten zu. Als abgeschlossen gilt die Aufgabe, wenn Autorisierungsserver CIMD-Unterstützung bekanntgeben und die aufgeführten CIMD- und MCP-Anforderungen erfüllen, ohne Fehler zu cachen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

auth enhancement needs decision P2

Summary

PR #1652 implemented client-side support for Client ID Metadata Documents (CIMD) per SEP-991, but the server-side implementation is missing. Authorization servers built with the Python SDK cannot currently support CIMD.

Background

CIMD (draft-ietf-oauth-client-id-metadata-document-00) allows OAuth clients to use HTTPS URLs as client identifiers, where the URL points to a JSON document containing client metadata. This is the recommended registration approach per the MCP spec (ahead of DCR).

From the MCP Authorization spec:

Authorization servers and MCP clients SHOULD support OAuth Client ID Metadata Documents

Current State

Client-side (implemented in #1652)

✅ is_valid_client_metadata_url() - validates HTTPS URLs with path component
✅ should_use_client_metadata_url() - checks if server advertises CIMD support
✅ create_client_info_from_metadata_url() - uses URL as client_id
✅ OAuth flow integration with DCR fallback

Server-side (missing)

❌ Never advertises client_id_metadata_document_supported=true in OAuth metadata
❌ No detection of URL-formatted client_ids
❌ No metadata document fetching
❌ No validation (client_id matching, redirect_uri verification, document structure)
❌ No caching infrastructure
❌ No SSRF protection for fetching

Spec Requirements for Authorization Servers

From the MCP spec and CIMD RFC:

Requirement	Level
Fetch metadata documents when encountering URL-formatted client_ids	SHOULD
Validate that fetched document's `client_id` matches the URL exactly	MUST
Validate redirect URIs against those in the metadata document	MUST
Validate document structure is valid JSON with required fields	MUST
Cache metadata respecting HTTP cache headers	SHOULD
Protect against SSRF attacks	SHOULD
Limit document size (~5KB recommended)	SHOULD
Display client_id hostname during consent	SHOULD
Never cache error responses	MUST NOT

References

MCP Spec: https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization#client-id-metadata-documents
CIMD RFC: https://datatracker.ietf.org/doc/html/draft-ietf-oauth-client-id-metadata-document-00
SEP-991: https://github.com/modelcontextprotocol/modelcontextprotocol/issues/991
Client-side PR: #1652
Original tracking issue: #1538 (closed prematurely - only client-side was implemented)

_{AI Disclaimer}

Vorherrschende Sprache: Python
Sterne: 24.3k
Forks: 4k
Ø Merge: 1 T. 11 Std.
Gemergte PRs (30 T.): 30

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus modelcontextprotocol/python-sdk

OAuth client scope handling breaks on comma-separated scope strings Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100

modelcontextprotocol/python-sdk#3566 · Erstellt am 23.9.2026
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) Offen

v1 v2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 85/100

modelcontextprotocol/python-sdk#3546 · 5 Kommentare · Erstellt am 19.9.2026
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) Offen

v1 v2

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100

modelcontextprotocol/python-sdk#3545 · 1 Kommentar · Erstellt am 18.9.2026
Revocation requires client_secret to be present Offen

v1 v2

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 91/100

modelcontextprotocol/python-sdk#3508 · 2 Kommentare · Erstellt am 15.9.2026
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? Offen

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 64/100

modelcontextprotocol/python-sdk#3504 · Erstellt am 15.9.2026

Alle Issues in modelcontextprotocol/python-sdk