Documentation
¶
Overview ¶
Package tools defines the MCP tools exposed by abs-mcp, split by the resource they act on (server.go, libraries.go, items.go, ...). Tools are named resource-first (library_*, item_*, me_*) so they group by what they act on.
Every tool is registered through add with a kind: read tools never change server state, write tools do (and are dropped under --read-only), and delete tools remove library records or files (and are only registered with --enable-delete). --allow-tools / --deny-tools further narrow the set.
Index ¶
Constants ¶
This section is empty.
Variables ¶
var EssentialTools = []string{
"library_list",
"library_search",
"library_items",
"item_get",
"item_chapters",
"user_in_progress",
"user_progress_get",
"user_progress_set",
}
EssentialTools is the curated preset selected by --allow-tools essential: enough to find things, read them, and keep listening progress in sync.
Functions ¶
Types ¶
type Options ¶
type Options struct {
// ReadOnly registers only tools that never change server state.
ReadOnly bool
// EnableDelete registers the tools that delete library items, podcast
// episodes and authors. Off unless the operator opts in.
EnableDelete bool
// Allow, when set, restricts registration to matching tools: exact names,
// prefix/suffix globs (library_*, *_delete) or the "essential" preset.
Allow []string
// Deny removes matching tools from whatever Allow left.
Deny []string
}
Options controls which tools are registered.