desktopconfig

package

v0.2.1 Latest Latest Go to latest Published: May 12, 2026 License: Apache-2.0 Imports: 7 Imported by: 0

Details

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

Repository

github.com/taufinity/cli

Links

Open Source Insights

Documentation ¶

Overview ¶

Package desktopconfig reads, updates, and writes Claude Desktop's MCP server config file (claude_desktop_config.json) atomically and without clobbering unrelated entries.

Index ¶

Variables
func DefaultClaudeDesktopPath() (string, error)
func HasServer(path, name string) (bool, error)
func RemoveServer(path, name string) error
func UpsertServer(path, name string, server any) error
type RemoteServer
type StdioServer

Constants ¶

This section is empty.

Variables ¶

View Source

var ErrUnsupportedOS = errors.New("Claude Desktop is not available on this OS; use --client print")

ErrUnsupportedOS indicates Claude Desktop is not available on the current OS.

Functions ¶

func DefaultClaudeDesktopPath ¶

func DefaultClaudeDesktopPath() (string, error)

DefaultClaudeDesktopPath returns the per-OS path to Claude Desktop's config.

func HasServer ¶

func HasServer(path, name string) (bool, error)

HasServer returns true if the named entry exists in "mcpServers".

func RemoveServer ¶

func RemoveServer(path, name string) error

RemoveServer removes the named entry from "mcpServers". No-op if the file or entry is absent.

func UpsertServer ¶

func UpsertServer(path, name string, server any) error

UpsertServer reads the JSON file at path (creating it if absent), inserts or updates the named MCP server entry under "mcpServers", and writes the result atomically (temp file + rename). All other top-level keys and sibling server entries are preserved.

server can be any JSON-marshalable value; in practice either RemoteServer (HTTP) or StdioServer (stdio bridge). The caller picks the shape; this function does not validate it.

Types ¶

type RemoteServer ¶

type RemoteServer struct {
	Type    string            `json:"type,omitempty"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
}

RemoteServer matches the JSON shape Claude Desktop expects for HTTP MCP servers, per docs/mcp/remote-setup.md.

type StdioServer ¶ added in v0.2.1

type StdioServer struct {
	Command string   `json:"command"`
	Args    []string `json:"args,omitempty"`
}

StdioServer matches the JSON shape Claude Desktop expects for a stdio MCP server: a subprocess invocation. The CLI uses this to install itself as a bridge (`taufinity mcp stdio`), which Claude Desktop launches and which forwards JSON-RPC frames to Studio's /mcp endpoint. The bearer token is NOT embedded — the bridge subprocess reads credentials.json at startup.

Source Files ¶

View all Source files

desktopconfig.go

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