Skip to content

v0.4.0 — One-command Claude Desktop setup

Choose a tag to compare

@alialbaker alialbaker released this 06 May 08:26
· 43 commits to main since this release

The big adoption-multiplier release

Before v0.4.0: getting cloudprice-mcp working in Claude Desktop required hand-editing JSON in obscure paths that vary by OS and install type, hitting platform-specific gotchas (Windows MS Store sandbox, macOS PATH issues, cached subprocess), and full-quitting Claude Desktop the right way for your platform. Real users hit 5+ friction points and bounced.

After v0.4.0:
```
pip install cloudprice-mcp
cloudprice-mcp setup
```

That's it. Restart Claude Desktop, 9 tools appear.

New commands

`cloudprice-mcp setup`

Auto-configures Claude Desktop on Windows / macOS / Linux:

  • Detects MS Store sandbox vs direct .exe install on Windows
  • Uses absolute Python path (required on macOS due to restrictive PATH)
  • Reads existing config and preserves preferences + other MCP servers
  • Shows the exact JSON before writing, asks Y/N
  • Kills cached cloudprice-mcp subprocesses
  • Prints platform-specific restart instructions

Trust spectrum (4 modes):

Command Use when
`cloudprice-mcp setup` Default — interactive prompt
`cloudprice-mcp setup --yes` Skip prompt (CI/scripts)
`cloudprice-mcp setup --dry-run` Preview changes without writing
`cloudprice-mcp setup --print-config` Output JSON only — for users who prefer manual paste

`cloudprice-mcp doctor`

Diagnoses install problems:

  • ✓ Python version (requires 3.10+)
  • ✓ Package installed at expected version
  • ✓ All 9 MCP tools register
  • ✓ Claude Desktop config file exists + valid JSON
  • ✓ Cloudprice entry present
  • ✓ Command field is absolute path that exists
  • ✓ Args field is sane

Backward compatibility

  • Default `cloudprice-mcp` (no args) still runs the MCP server (same as v0.3.x)
  • Existing Claude Desktop configs continue to work unchanged
  • New `cloudprice-mcp serve` alias is available for explicit invocation

Docs

  • New INSTALL.md: step-by-step Windows + macOS + Linux manual install + troubleshooting
  • README rewritten around the auto-setup flow

Tests

56/56 passing (was 41 in v0.3). 15 new tests covering setup + doctor logic.

Install

```bash
pip install --upgrade cloudprice-mcp
cloudprice-mcp setup
```