# Shopify Global Catalog MCP Adapter

This Python service exposes a legacy SSE MCP endpoint that XiaoYi can register as a plugin. It translates the `search_catalog` call into Shopify's Streamable HTTP MCP request and always supplies Shopify's required UCP agent profile.

## MCP endpoint

When deployed with `MCP_TRANSPORT=sse`, the MCP SDK exposes its legacy SSE endpoint at:

```text
/sse
```

Register that full URL in XiaoYi, not Shopify's original endpoint.

## Local setup

```bash
cd /Users/hanlufeng/Desktop/AI-INSIGHT-REPORT/Ceilia/shopify-global-catalog-mcp-adapter
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"
pytest
```

## Run locally

For a local command-line MCP client:

```bash
python -m shopify_global_catalog_mcp_adapter.server
```

For SSE HTTP mode:

```bash
MCP_TRANSPORT=sse PORT=8080 python -m shopify_global_catalog_mcp_adapter.server
```

## Deploy to Cloud Run

Create a Cloud Run service from this directory using Buildpacks. Set the entrypoint to:

```text
python -m shopify_global_catalog_mcp_adapter.server
```

Set environment variable:

```text
MCP_TRANSPORT=sse
```

After deployment, use:

```text
https://YOUR-CLOUD-RUN-DOMAIN/sse
```

in XiaoYi's MCP plugin configuration. The plugin should then load the `search_catalog` tool.