sgr-admin-mcp

MCP stdio connector for the Sgr Admin Shopify app. It bridges a stdio-only MCP client (such as Claude Desktop) to Sgr Admin's hosted MCP endpoint, so an AI agent can operate on your shop's products and images.

Modern MCP clients that support remote HTTP MCP servers don't need this package — just point them at your MCP URL with the API key as a Bearer token. Use this connector only for clients that speak stdio.

Get a URL + API key

In Sgr Admin, open MCP → API 密钥, create a key, and copy:

• url — e.g. https://<your-app>/mcp
• apikey — sgr_... (shown once at creation)

Each key is bound to the shop it was created in.

One-click install (Codex & Claude)

Register the server into every MCP client found on your machine with one command:

npx sgr-admin-mcp install --url https://<your-app>/mcp --apikey sgr_xxx

It sets up:

• Codex CLI — via codex mcp add, or by writing ~/.codex/config.toml directly if the codex CLI isn't on PATH
• Claude Code — via claude mcp add --scope user
• Claude Desktop — merges into claude_desktop_config.json

It also installs the sgr-product-images skill (a guided workflow to download, edit/AI-expand, back up, and replace a product's images) into ~/.claude/skills/. Claude Code picks it up automatically; Claude Desktop that doesn't read that path can import the same folder from its Skills settings.

Clients whose CLI isn't installed are skipped (re-run after installing them). Options: --client codex|claude-code|claude-desktop|all (default all), --name <name> (default sgr-admin), --no-skill to skip the skill. Restart the client after installing.

Usage (manual / stdio bridge)

npx sgr-admin-mcp --url https://<your-app>/mcp --apikey sgr_xxx

Or via environment variables:

SGR_ADMIN_MCP_URL=https://<your-app>/mcp SGR_ADMIN_API_KEY=sgr_xxx npx sgr-admin-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sgr-admin": {
      "command": "npx",
      "args": [
        "-y",
        "sgr-admin-mcp",
        "--url",
        "https://<your-app>/mcp",
        "--apikey",
        "sgr_xxx"
      ]
    }
  }
}

Tools

• list_products — list products (paginated, searchable)
• get_product_images — a product's media images (mediaId + url)
• download_product_images — download a product's image bytes (base64)
• replace_product_image — replace a product image with a new image URL
• expand_and_replace_product_image — AI-expand a product image and replace it
• list_backups — image backup history (incl. S3 folder / object keys)
• restore_backup — restore a backup to the product's media

Security

Treat the API key like a password — it grants an agent write access to your shop's products and images. Revoke it any time from the API 密钥 page.

License

MIT