mayros mcp-setup

Register Mayros as an MCP server in Claude Desktop or Claude Code with a single command. Resolves absolute paths to node and mayros.mjs automatically.

Options

OptionDescription
--desktopConfigure Claude Desktop (writes config file)
--stdioUse stdio transport (default)
--httpUse HTTP transport (connect to pre-running server)
--port <port>HTTP port (default: 19100)
--host <host>HTTP host (default: 127.0.0.1)

Targets

Claude Code (default)

bash
mayros mcp-setup

Runs claude mcp add mayros -- mayros serve --stdio to register the server. If Claude Code is not found, prints the manual command.

For HTTP transport:

bash
mayros mcp-setup --http --port 19100

Runs claude mcp add mayros -s http --url http://127.0.0.1:19100/mcp.

Claude Desktop

bash
mayros mcp-setup --desktop

Writes to the Claude Desktop configuration file:

PlatformConfig path
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%/Claude/claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

The command:

  1. Resolves the absolute path to node (via which node or common fallback paths)
  2. Resolves the absolute path to mayros.mjs (global npm install or local source)
  3. Reads existing config and merges the mayros entry into mcpServers
  4. Writes the updated config

Restart Claude Desktop after running this command.

Examples

bash
# Register with Claude Code (stdio)
mayros mcp-setup

# Register with Claude Desktop
mayros mcp-setup --desktop

# Register HTTP transport with custom port
mayros mcp-setup --http --port 8080

# Register HTTP transport with custom host
mayros mcp-setup --http --host 0.0.0.0 --port 19100
  • serve — start the MCP server
  • MCP Server — feature overview and tool reference
  • MCP Client — connect to external MCP servers