kubernetes-mcp-server

package api import "context" // ServerPrompt represents a prompt that can be registered with the MCP server. // Prompts provide pre-defined workflow templates and guidance to AI assistants. type ServerPrompt struct { Prompt Prompt Handler PromptHandlerFunc ClusterAware *bool ArgumentSchema map[string]PromptArgument } // IsClusterAware indicates whether the prompt can accept a "cluster" or "context" parameter // to operate on a specific Kubernetes cluster context. // Defaults to true if not explicitly set func (s *ServerPrompt) IsClusterAware() bool { if s.ClusterAware != nil { return *s.ClusterAware } return true } // Prompt represents the metadata and content of an MCP prompt. // See MCP specification: https://spec.modelcontextprotocol.io/specification/server/prompts/ type Prompt struct { Name string `json:"name" toml:"name"` Title string `json:"title,omitempty" toml:"title,omitempty"` Description string `json:"description,omitempty" toml:"description,omitempty"` Arguments []PromptArgument `json:"arguments,omitempty" toml:"arguments,omitempty"` Templates []PromptTemplate `json:"messages,omitempty" toml:"messages,omitempty"` } // PromptArgument defines a parameter that can be passed to a prompt. // See MCP specification: https://spec.modelcontextprotocol.io/specification/server/prompts/ type PromptArgument struct { Name string `json:"name" toml:"name"` Description string `json:"description,omitempty" toml:"description,omitempty"` Required bool `json:"required" toml:"required"` } // PromptTemplate represents a message template from configuration with placeholders like {{arg}}. // This is used for configuration parsing and gets rendered into PromptMessage at runtime. type PromptTemplate struct { Role string `json:"role" toml:"role"` Content string `json:"content" toml:"content"` } // PromptMessage represents a single message in a prompt response. // See MCP specification: https://spec.modelcontextprotocol.io/specification/server/prompts/ type PromptMessage struct { Role string `json:"role" toml:"role"` Content PromptContent `json:"content" toml:"content"` } // PromptContent represents the content of a prompt message. // See MCP specification: https://spec.modelcontextprotocol.io/specification/server/prompts/ type PromptContent struct { Type string `json:"type" toml:"type"` Text string `json:"text,omitempty" toml:"text,omitempty"` } // PromptCallRequest interface for accessing prompt call arguments type PromptCallRequest interface { GetArguments() map[string]string } // PromptCallResult represents the result of executing a prompt type PromptCallResult struct { Description string Messages []PromptMessage Error error } // NewPromptCallResult creates a new PromptCallResult func NewPromptCallResult(description string, messages []PromptMessage, err error) *PromptCallResult { return &PromptCallResult{ Description: description, Messages: messages, Error: err, } } // PromptHandlerParams contains the parameters passed to a prompt handler type PromptHandlerParams struct { context.Context ExtendedConfigProvider KubernetesClient PromptCallRequest } // PromptHandlerFunc is a function that handles prompt execution type PromptHandlerFunc func(params PromptHandlerParams) (*PromptCallResult, error)