Files
LocalAI/pkg/mcp/localaitools/server.go
Ettore Di Giacinto eba08c195a feat(mcp): add set_alias and list_aliases tools
Expose model-alias management over the LocalAI Assistant MCP surface:
list_aliases (read-only, GET /api/aliases) and set_alias (mutating).
SetAlias is swap-first: PATCH /api/models/config-json/:name swaps an
existing alias's target (validated, non-destructive) and a 404 falls
back to POST /models/import to create a fresh {name, alias} config. The
inproc client mirrors this via ConfigService.PatchConfig + a create path
modeled on ImportModelEndpoint. Deletion reuses delete_model.

Assisted-by: Claude:claude-opus-4 [Claude Code]
Signed-off-by: Ettore Di Giacinto <mudler@localai.io>
2026-06-20 10:01:23 +00:00

58 lines
1.6 KiB
Go

package localaitools
import (
"github.com/modelcontextprotocol/go-sdk/mcp"
"github.com/mudler/LocalAI/internal"
)
// Options control which tools the server registers and how the embedded
// skill prompts are surfaced.
type Options struct {
// DisableMutating omits all tools that change server state. Used by the
// "--read-only" flavour of the standalone stdio CLI.
DisableMutating bool
// ServerName overrides the MCP server's advertised Implementation.Name.
// Defaults to "localai-admin".
ServerName string
// ServerVersion overrides the advertised version. Defaults to the linked
// internal.PrintableVersion().
ServerVersion string
}
// NewServer builds an MCP server that exposes LocalAI's admin surface as
// tools, backed by the supplied LocalAIClient. The same server type is used
// in-process (paired in-memory transport) and out-of-process (stdio).
func NewServer(client LocalAIClient, opts Options) *mcp.Server {
name := opts.ServerName
if name == "" {
name = DefaultServerName
}
version := opts.ServerVersion
if version == "" {
version = internal.PrintableVersion()
}
srv := mcp.NewServer(&mcp.Implementation{
Name: name,
Version: version,
}, &mcp.ServerOptions{
Instructions: SystemPrompt(opts),
})
registerModelTools(srv, client, opts)
registerAliasTools(srv, client, opts)
registerBackendTools(srv, client, opts)
registerConfigTools(srv, client, opts)
registerSystemTools(srv, client, opts)
registerStateTools(srv, client, opts)
registerBrandingTools(srv, client, opts)
registerUsageTools(srv, client, opts)
registerPIITools(srv, client, opts)
registerMiddlewareTools(srv, client, opts)
return srv
}