Shopify Global Catalog 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:

/sse

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

Local setup

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:

python -m shopify_global_catalog_mcp_adapter.server

For SSE HTTP mode:

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:

python -m shopify_global_catalog_mcp_adapter.server

Set environment variable:

MCP_TRANSPORT=sse

After deployment, use:

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

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