Add Server Cards example (SEP-2127) - #2692
Closed
dsp-ant wants to merge 1 commit into
Closed
Conversation
Copy link
Copy Markdown
Member
Sorry, something went wrong.
Adds a self-contained example package under examples/server-card showing how clients can consume and validate an MCP Server Card and how servers can generate and publish one. - mcp_server_card/types.py: Pydantic port of the Server Card / Server schema, following mcp.types conventions (camelCase wire format, reuses Icon). - mcp_server_card/validation.py: JSON Schema validation against the bundled schema plus semantic guards (e.g. rejecting version ranges). - mcp_server_card/client.py: fetch/load + validate a card from the conventional .well-known location. - mcp_server_card/server.py: build a card and either write it to a file or serve it from a Starlette app / MCPServer. - mcp_server_card/cli.py: validate, fetch, and print the schema. - examples/ and tests/ covering both the client and server flows.
Comment thread
examples/server-card/examples/consume_card.py
| for header in remote.headers or []: | ||
| flags = "required" if header.is_required else "optional" | ||
| secret = ", secret" if header.is_secret else "" | ||
| print(f" header {header.name} ({flags}{secret})") |
dsp-ant
marked this pull request as draft
May 26, 2026 16:11
Copy link
Copy Markdown
Member
Author
|
Superseded by the in-SDK implementation (experimental namespaces) — see the new PR. |
Sorry, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Reviewers
1 more reviewer2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a self-contained example package under examples/server-card/ demonstrating
MCP Server Cards (SEP-2127)
in Python: clients consuming and validating a card, and servers generating and
publishing one. It ports the TypeScript source of truth in
experimental-ext-server-card
and follows mcp.types conventions, so the mcp_server_card/ library could later
be lifted into mcp/experimental/server_card/ largely unchanged.
A Server Card is a static metadata document (typically at
https://<host>/.well-known/mcp/server-card) describing a remote server's
identity, transport endpoints, and supported protocol versions, so a client can
discover and connect to it before initialization.
Layout
Design
Validation
Open questions