mcp

package

v2.5.0 Latest Latest Go to latest Published: Oct 2, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation ¶

Overview ¶

Package mcp is the MCP front door (docs/adr/0016): agents read, draft and propose through the same engine as people, with their person's authority and no more. Like the HTTP API and the sync socket, it is a driving adapter; it decides nothing the engine does not.

It is stateless: every request stands alone (MCP's sessionless transport), so it holds nothing open and a deployment still scales to zero (docs/adr/0015).

Index ¶

func Handler(o Options) http.Handler
func ServeStdio(ctx context.Context, o Options) error
type Options
type Presence

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Handler ¶

func Handler(o Options) http.Handler

Handler serves MCP over HTTP, sessionless. The principal is the one the authentication middleware put on the request: the person the agent acts for.

func ServeStdio ¶

func ServeStdio(ctx context.Context, o Options) error

ServeStdio serves MCP over stdin and stdout, for an agent on the operator's own machine: anonymous, as the command line is, and held to the same ceiling.

Types ¶

type Options ¶

type Options struct {
	Engine *engine.Engine
	// Authz decides whether a principal may act through an agent at all
	// (auth.ResourceAgent); nil allows it.
	Authz    auth.Authorizer
	Reports  reporting.Reporter
	Presence Presence
	Version  string
}

Options are what the MCP server works through.

type Presence ¶

type Presence interface {
	AnnounceAgent(ctx context.Context, docID, actor, name string)
}

Presence announces an agent on a document, so the people on it see it working. The sync socket implements it; nil announces nothing.

Source Files ¶

View all Source files

mcp.go

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