server

package
v0.2.7 Latest Latest
Warning

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

 Go to latest Published: May 21, 2025 License: Apache-2.0 Imports: 20 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	AllowOriginHeader       = "Access-Control-Allow-Origin"
	AllowHeadersHeader      = "Access-Control-Allow-Headers"
	AllowMethodsHeader      = "Access-Control-Allow-Methods"
	AllControlRequestHeader = "Access-Control-Request-Method"
	AllowCredentialsHeader  = "Access-Control-Allow-Credentials"
	ExposeHeadersHeader     = "Access-Control-Expose-Headers"
	MaxAgeHeader            = "Access-Control-Max-Age"
	Separator               = ", "
)

Variables

This section is empty.

Functions

func ChainMiddlewareHandlers added in v0.2.5 

func ChainMiddlewareHandlers(h http.Handler, mws ...Middleware) http.Handler

ChainMiddlewareHandlers chains multiple middleware handlers together

Types

type Adapter added in v0.2.5 

type Adapter struct {
	// contains filtered or unexported fields
}

Adapter adapts a server Handler to implement the client.Interface

func NewAdapter added in v0.2.5 

func NewAdapter(handler *Handler) *Adapter

NewAdapter creates a new adapter for the given handler

func (*Adapter) CallTool added in v0.2.5 

func (a *Adapter) CallTool(ctx context.Context, params *schema.CallToolRequestParams) (*schema.CallToolResult, error)

CallTool calls a tool

func (*Adapter) Complete added in v0.2.5 

func (a *Adapter) Complete(ctx context.Context, params *schema.CompleteRequestParams) (*schema.CompleteResult, error)

Complete completes a request

func (*Adapter) GetPrompt added in v0.2.5 

func (a *Adapter) GetPrompt(ctx context.Context, params *schema.GetPromptRequestParams) (*schema.GetPromptResult, error)

GetPrompt gets a prompt

func (*Adapter) Initialize added in v0.2.5 

func (a *Adapter) Initialize(ctx context.Context) (*schema.InitializeResult, error)

Initialize initializes the client

func (*Adapter) ListPrompts added in v0.2.5 

func (a *Adapter) ListPrompts(ctx context.Context, cursor *string) (*schema.ListPromptsResult, error)

ListPrompts lists prompts

func (*Adapter) ListResourceTemplates added in v0.2.5 

func (a *Adapter) ListResourceTemplates(ctx context.Context, cursor *string) (*schema.ListResourceTemplatesResult, error)

ListResourceTemplates lists resource templates

func (*Adapter) ListResources added in v0.2.5 

func (a *Adapter) ListResources(ctx context.Context, cursor *string) (*schema.ListResourcesResult, error)

ListResources lists resources

func (*Adapter) ListTools added in v0.2.5 

func (a *Adapter) ListTools(ctx context.Context, cursor *string) (*schema.ListToolsResult, error)

ListTools lists tools

func (*Adapter) Ping added in v0.2.5 

func (a *Adapter) Ping(ctx context.Context, params *schema.PingRequestParams) (*schema.PingResult, error)

Ping pings the server

func (*Adapter) ReadResource added in v0.2.5 

func (a *Adapter) ReadResource(ctx context.Context, params *schema.ReadResourceRequestParams) (*schema.ReadResourceResult, error)

ReadResource reads a resource

func (*Adapter) SetLevel added in v0.2.5 

func (a *Adapter) SetLevel(ctx context.Context, params *schema.SetLevelRequestParams) (*schema.SetLevelResult, error)

SetLevel sets the logging level

func (*Adapter) Subscribe added in v0.2.5 

func (a *Adapter) Subscribe(ctx context.Context, params *schema.SubscribeRequestParams) (*schema.SubscribeResult, error)

Subscribe subscribes to a resource

func (*Adapter) Unsubscribe added in v0.2.5 

func (a *Adapter) Unsubscribe(ctx context.Context, params *schema.UnsubscribeRequestParams) (*schema.UnsubscribeResult, error)

Unsubscribe unsubscribes from a resource

type Client 

type Client struct{ transport.Transport }

func (*Client) CreateMessage 

func (c *Client) CreateMessage(ctx context.Context, params *schema.CreateMessageRequestParams) (*schema.CreateMessageResult, *jsonrpc.Error)

CreateMessage creates sampling message

func (*Client) ListRoots 

func (c *Client) ListRoots(ctx context.Context, params *schema.ListRootsRequestParams) (*schema.ListRootsResult, *jsonrpc.Error)

type Cors added in v0.2.5 

type Cors struct {
	AllowCredentials *bool    `yaml:"AllowCredentials,omitempty"`
	AllowHeaders     []string `yaml:"AllowHeaders,omitempty"`
	AllowMethods     []string `yaml:"AllowMethods,omitempty"`
	AllowOrigins     []string `yaml:"AllowOrigins,omitempty"`
	ExposeHeaders    []string `yaml:"ExposeHeaders,omitempty"`
	MaxAge           *int64   `yaml:"MaxAge,omitempty"`
}

func (*Cors) OriginMap added in v0.2.5 

func (c *Cors) OriginMap() map[string]bool

type Handler 

type Handler struct {
	transport.Notifier
	*Logger
	*Server

	Initialized bool
	// contains filtered or unexported fields
}

Handler represents handler

func (*Handler) CallTool 

func (h *Handler) CallTool(ctx context.Context, request *jsonrpc.Request) (*schema.CallToolResult, *jsonrpc.Error)

CallTool handles the tools/call method

func (*Handler) Cancel 

func (h *Handler) Cancel(ctx context.Context, notification *jsonrpc.Notification) *jsonrpc.Error

func (*Handler) Complete 

func (h *Handler) Complete(ctx context.Context, request *jsonrpc.Request) (*schema.CompleteResult, *jsonrpc.Error)

Complete handles the completion/complete method

func (*Handler) GetPrompt 

func (h *Handler) GetPrompt(ctx context.Context, request *jsonrpc.Request) (*schema.GetPromptResult, *jsonrpc.Error)

GetPrompt handles the prompts/get method

func (*Handler) Initialize 

func (h *Handler) Initialize(ctx context.Context, request *jsonrpc.Request) (*schema.InitializeResult, *jsonrpc.Error)

Initialize handles the initialize method

func (*Handler) ListPrompts 

func (h *Handler) ListPrompts(ctx context.Context, request *jsonrpc.Request) (*schema.ListPromptsResult, *jsonrpc.Error)

ListPrompts handles the prompts/list method

func (*Handler) ListResourceTemplates 

func (h *Handler) ListResourceTemplates(ctx context.Context, request *jsonrpc.Request) (*schema.ListResourceTemplatesResult, *jsonrpc.Error)

ListResourceTemplates handles the resources/templates/list method

func (*Handler) ListResources 

func (h *Handler) ListResources(ctx context.Context, request *jsonrpc.Request) (*schema.ListResourcesResult, *jsonrpc.Error)

ListResources handles the resources/list method

func (*Handler) ListTools 

func (h *Handler) ListTools(ctx context.Context, request *jsonrpc.Request) (*schema.ListToolsResult, *jsonrpc.Error)

ListTools handles the tools/list method

func (*Handler) OnNotification 

func (h *Handler) OnNotification(ctx context.Context, notification *jsonrpc.Notification)

OnNotification handles incoming JSON-RPC notifications

func (*Handler) Ping 

func (h *Handler) Ping(ctx context.Context, request *jsonrpc.Request) (*schema.PingResult, *jsonrpc.Error)

Ping handles the ping method

func (*Handler) ReadResource 

func (h *Handler) ReadResource(ctx context.Context, request *jsonrpc.Request) (*schema.ReadResourceResult, *jsonrpc.Error)

ReadResource handles the resources/read method

func (*Handler) Serve 

func (h *Handler) Serve(parent context.Context, request *jsonrpc.Request, response *jsonrpc.Response)

Serve handles incoming JSON-RPC requests

func (*Handler) SetLevel 

func (h *Handler) SetLevel(ctx context.Context, request *jsonrpc.Request) (*schema.SetLevelResult, *jsonrpc.Error)

SetLevel handles the logging/setLevel method

func (*Handler) Subscribe 

func (h *Handler) Subscribe(ctx context.Context, request *jsonrpc.Request) (*schema.SubscribeResult, *jsonrpc.Error)

Subscribe handles the resources/subscribe method

func (*Handler) Unsubscribe 

func (h *Handler) Unsubscribe(ctx context.Context, request *jsonrpc.Request) (*schema.UnsubscribeResult, *jsonrpc.Error)

Unsubscribe handles the resources/unsubscribe method

type Logger 

type Logger struct {
	// contains filtered or unexported fields
}

func NewLogger 

func NewLogger(name string, level *schema.LoggingLevel, notifier transport.Notifier) *Logger

func (*Logger) Alert 

func (l *Logger) Alert(ctx context.Context, data interface{}) error

func (*Logger) Critical 

func (l *Logger) Critical(ctx context.Context, data interface{}) error

func (*Logger) Debug 

func (l *Logger) Debug(ctx context.Context, data interface{}) error

func (*Logger) Emergency 

func (l *Logger) Emergency(ctx context.Context, data interface{}) error

func (*Logger) Error 

func (l *Logger) Error(ctx context.Context, data interface{}) error

func (*Logger) Info 

func (l *Logger) Info(ctx context.Context, data interface{}) error

func (*Logger) Logger 

func (l *Logger) Logger(name string) logger.Logger

Logger creates a new logger with a name

func (*Logger) Notice 

func (l *Logger) Notice(ctx context.Context, data interface{}) error

func (*Logger) Warning 

func (l *Logger) Warning(ctx context.Context, data interface{}) error

type Middleware added in v0.2.5 

type Middleware func(next http.Handler) http.Handler

Middleware is a function that takes an http.Handler and returns an http.Handler

type Option 

type Option func(s *Server) error

Option is a function that configures the server.

func WithAuthorizer 

func WithAuthorizer(authorizer Middleware) Option

WithAuthorizer adds a new authorizer to the server.

func WithCORS added in v0.2.5 

func WithCORS(cors *Cors) Option

WithCORS adds a new CORS handler to the server.

func WithImplementation 

func WithImplementation(implementation schema.Implementation) Option

WithImplementation sets the server implementation.

func WithJRPCAuthorizer added in v0.2.5 

func WithJRPCAuthorizer(authorizer auth.JRPCAuthorizer) Option

WithJRPCAuthorizer adds a new JRPCAuthorizer to the server.

func WithLoggerName 

func WithLoggerName(name string) Option

WithLoggerName sets the logger name.

func WithNewImplementer 

func WithNewImplementer(newImplementer server.NewImplementer) Option

WithNewImplementer sets the new implementer.

func WithProtectedResourcesHandler added in v0.2.5 

func WithProtectedResourcesHandler(handler http.HandlerFunc) Option

type Server 

type Server struct {
	// contains filtered or unexported fields
}

Server represents MCP protocol handler

func New 

func New(options ...Option) (*Server, error)

New creates a new Server instance

func (*Server) AsClient added in v0.2.5 

func (s *Server) AsClient(ctx context.Context) client.Interface

AsClient returns a client.Interface implementation that uses this server directly

func (*Server) HTTP 

func (s *Server) HTTP(_ context.Context, addr string) *http.Server

HTTP return http server HTTP creates and returns an HTTP server with OAuth2 authorizer and SSE handlers.

func (*Server) NewHandler 

func (s *Server) NewHandler(ctx context.Context, transport transport.Transport) transport.Handler

NewHandler creates a new handler instance

func (*Server) Stdio 

func (s *Server) Stdio(ctx context.Context) *stdio.Server

Stdio return stdio server

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.