Skip to content

docs(servercard): add developer guidance and validation fixes#5

Merged
SamMorrowDrums merged 2 commits into
experimental-server-cardfrom
sammorrowdrums-port-developer-guidance
Jul 21, 2026
Merged

docs(servercard): add developer guidance and validation fixes#5
SamMorrowDrums merged 2 commits into
experimental-server-cardfrom
sammorrowdrums-port-developer-guidance

Conversation

@SamMorrowDrums

Copy link
Copy Markdown
Owner

Summary

  • add generated Go developer guidance for building, serving, and statically publishing experimental Server Cards
  • document the intended AI Catalog discovery direction, security boundaries, schema publication caveat, and current SDK scope
  • add compile-checked examples and link the guide from the existing documentation overview
  • align validation with the draft v1 schema, including nested enums, strict URIs, Unicode lengths, and exact-version handling
  • prevent shared caches from retaining handler error responses

Context

This is a focused follow-up to the Server Card reference implementation in experimental-server-card / modelcontextprotocol#1024. The guide adapts the structure of modelcontextprotocol/python-sdk#2951 and SamMorrowDrums/python-sdk#1 to Go APIs and repository conventions.

Discovery guidance follows the intended direction in modelcontextprotocol/experimental-ext-server-card#42 rather than the obsolete MCP-specific catalog format. The canonical v1 schema identifier currently returns 404 while the extension is pre-release, so the guide links the extension repository's generated schema payload and authoritative TypeScript source.

Validation

  • go generate ./internal/docs
  • go test ./...

@SamMorrowDrums
SamMorrowDrums force-pushed the experimental-server-card branch from ef93f97 to d4fcacc Compare July 20, 2026 20:43
Validate nested input formats, icon themes, URIs, Unicode lengths, and
exact versions. Avoid caching handler error responses.

Co-authored-by: Copilot App <[email protected]>
Copilot-Session: 38f143e1-c0ff-47a9-ae4d-fd6ea9a5b7fd
@SamMorrowDrums
SamMorrowDrums force-pushed the sammorrowdrums-port-developer-guidance branch from 3491169 to 027c4b3 Compare July 20, 2026 20:45
Document building, serving, and publishing Server Cards with the Go SDK,
including AI Catalog context, security guidance, and checked examples.

Co-authored-by: Copilot App <[email protected]>
Copilot-Session: 38f143e1-c0ff-47a9-ae4d-fd6ea9a5b7fd
@SamMorrowDrums
SamMorrowDrums force-pushed the sammorrowdrums-port-developer-guidance branch from 027c4b3 to 0553d74 Compare July 20, 2026 20:49
@SamMorrowDrums
SamMorrowDrums merged commit 96edebb into experimental-server-card Jul 21, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant