mcpserver

package
v0.38.0 Latest Latest
Warning

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

Go to latest
Published: Sep 9, 2026 License: Apache-2.0 Imports: 8 Imported by: 0

Documentation

Overview

Package mcpserver exposes aeman's board operations as a Model Context Protocol (MCP) server over stdio. Its tool set is a 1:1 projection of the /api/v1 resource API (Board/Card/Note resources, actions, LIST selectors), calling the boardservice layer — the same logic behind the HTTP handlers — not proxying GitHub directly.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func New

func New(cfg Config) *mcp.Server

New builds an MCP server with the aeman tool set.

func Serve

func Serve(ctx context.Context, s *mcp.Server) error

Serve runs an MCP server over stdio until ctx is cancelled or the client disconnects.

Types

type Config

type Config struct {
	// Board is the default board — the name of its primary repository.
	Board string
	// Lock pins the board, ignoring per-tool overrides.
	Lock bool
	// Version is reported to MCP clients.
	Version string
	// ResolveLogin returns the caller's own login, used to scope the default
	// (unspecified-view) list to their personal Me board. Optional: when nil
	// or it errors, an unspecified list falls back to the Me view for
	// everyone in the active sprint rather than a personal one.
	ResolveLogin func(ctx context.Context) (string, error)
	// Backend is the board backend every tool call runs on — the server's
	// shared store, so MCP writes update the cache and reach watch clients
	// like every other write; the caller's identity and rights ride the
	// call's context.
	Backend boardservice.Backend
}

Config configures the MCP server.

Jump to

Keyboard shortcuts

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