musterbridge

package

v0.2.3 Latest Latest Go to latest Published: Jun 15, 2026 License: Apache-2.0 Imports: 14 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/giantswarm/klausctl

Links

Open Source Insights

Documentation ¶

Rendered for

Overview ¶

Package musterbridge manages the lifecycle of a shared local muster process that aggregates stdio MCP servers behind an HTTP endpoint. Containers reach muster via host.docker.internal, giving agents access to the same MCP tools the user has in their IDE.

Index ¶

Constants
func EnsureRunning(ctx context.Context, paths *config.Paths) error
func Stop(paths *config.Paths) error
type MCPServerEntry
type Status

Constants ¶

View Source

const (
	DefaultPort = 8090
	BridgeName  = "muster"
)

Variables ¶

This section is empty.

Functions ¶

func EnsureRunning ¶

func EnsureRunning(ctx context.Context, paths *config.Paths) error

EnsureRunning starts the muster bridge if it is not already running and guarantees the bridge entry exists in the MCP server store. Used by the auto-start integration in the instance start flow.

func Stop ¶

func Stop(paths *config.Paths) error

Stop terminates the running muster process and cleans up state files.

Types ¶

type MCPServerEntry ¶

type MCPServerEntry struct {
	Name string `json:"name"`
	File string `json:"file"`
}

MCPServerEntry describes an MCP server file found in the muster config directory.

type Status ¶

type Status struct {
	Running    bool             `json:"running"`
	PID        int              `json:"pid,omitempty"`
	Port       int              `json:"port,omitempty"`
	URL        string           `json:"url,omitempty"`
	MCPServers []MCPServerEntry `json:"mcpServers,omitempty"`
}

Status represents the state of the muster bridge.

func GetStatus ¶

func GetStatus(paths *config.Paths) *Status

GetStatus returns the current muster bridge status without modifying anything.

func Restart ¶

func Restart(ctx context.Context, paths *config.Paths) (*Status, error)

Restart stops and re-starts the muster bridge. Useful after config changes.

func Start ¶

func Start(ctx context.Context, paths *config.Paths) (*Status, error)

Start launches a muster serve process in the background. It is idempotent: if muster is already running and healthy, it returns nil.

Source Files ¶

View all Source files

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