mcp-servercard-go

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 4, 2026 License: MIT

README

mcp-servercard-go

Go library implementing SEP-2127 MCP Server Cards. Drop-in middleware for any go-sdk MCP server.

A Server Card is a JSON document served at /.well-known/mcp-server-card that describes an MCP server before connection: identity, transports, capabilities, and authentication requirements. This enables pre-connect discovery without a full initialization handshake.

Usage

import "github.com/olgasafonova/mcp-servercard-go/servercard"

server := mcp.NewServer(&mcp.Implementation{
    Name:    "gleif-mcp-server",
    Version: "1.4.0",
}, nil)

// ... register tools, prompts, resources ...

// Attach returns an http.Handler for the well-known endpoint
// and registers the card as an MCP resource.
cardHandler := servercard.Attach(server, servercard.Options{
    Name:        "io.github.olgasafonova/gleif-mcp-server",
    Version:     "1.4.0",
    Description: "Access the GLEIF LEI database for company verification.",
    Title:       "GLEIF MCP Server",
    WebsiteURL:  "https://github.com/olgasafonova/gleif-mcp-server",
    Remotes: []servercard.Remote{{
        Type: "streamable-http",
        URL:  "/mcp",
        Authentication: &servercard.Auth{Required: false, Schemes: []string{}},
    }},
    Capabilities: &servercard.Capabilities{
        Tools:   &servercard.ToolsCap{ListChanged: false},
        Prompts: &servercard.PromptsCap{ListChanged: false},
    },
    Provider: &servercard.Provider{
        Name: "Olga Safonova",
        URL:  "https://github.com/olgasafonova",
    },
})

// Mount alongside your MCP handler.
mux := http.NewServeMux()
mux.Handle("/mcp", mcpHandler)
mux.Handle(servercard.WellKnownPath, cardHandler)

What it does

  1. Builds a Server Card JSON document conforming to the SEP-2127 schema
  2. Serves it at /.well-known/mcp-server-card with correct CORS and caching headers
  3. Registers it as an MCP resource at mcp://server-card.json so connected clients can read it too

API

Function Purpose
Attach(server, opts) One-line setup: builds card, registers resource, returns HTTP handler
Build(opts) Builds a *ServerCard struct from options
Handler(card) Returns an http.Handler serving the card JSON
RegisterResource(server, card) Registers the card as an MCP resource

References

License

MIT

Directories

Path Synopsis
Package servercard implements SEP-2127 MCP Server Cards.
Package servercard implements SEP-2127 MCP Server Cards.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL