This is a thin npx wrapper that finds uvx on your system and launches the Python MCP server. It solves the common problem of GUI apps (Claude Desktop, Cursor, etc.) not finding uvx in PATH.

Prerequisites

Node.js 18+ (for npx)
uv — install from astral.sh/uv:
```
curl -LsSf https://astral.sh/uv/install.sh | sh   # macOS / Linux
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows
```

Usage

npx -y @imagin.studio/api-docs-mcp

Or in your agent's MCP config:

{
  "imagin-docs": {
    "command": "npx",
    "args": ["-y", "@imagin.studio/api-docs-mcp"]
  }
}

Full setup guide

For step-by-step instructions for 7 coding agents (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + Copilot, Cline, Zed), see the full setup guide on PyPI:

https://pypi.org/project/imagin-studio-api-docs-mcp/

How it works

The npx wrapper probes common uvx install locations (~/.local/bin, Homebrew, cargo) and spawns uvx imagin-studio-api-docs-mcp, which downloads and runs the Python MCP server. On first run, the server clones the docs and builds a local vector index (~20-30 seconds).