Appearance
CLI
Install the npm launcher (downloads the matching portable binary on first run):
bash
npm i -g sumeru-mcp
sumeru doctor
sumeru mcp-stdio # or just: sumeru
sumeru mcp-stdio --key "work repo" # scope to an API key (default: Default)
sumeru gui # desktop UI (on macOS: opens Sumeru.app)
sumeru gui --hidden # tray-only start
sumeru engine # internal: gateway + JSON API on stdin/stdout (used by the macOS app)On Linux, the portable binary needs system WebKitGTK. For a casual desktop install, prefer the AppImage or .deb from GitHub Releases.
Stdio MCP host config
json
{
"mcpServers": {
"sumeru": {
"command": "sumeru",
"args": ["mcp-stdio"]
}
}
}Overrides
SUMERU_BINARY— local binary pathSUMERU_VERSION— release version to downloadSUMERU_CACHE_DIR— cache directory for binaries
Doctor
sumeru doctor reports CLI version, platform, cached binary, config dir writability, and whether something answers on :7341/mcp.