Shopify MCP Proxy & Mock Server
by ramakay
This project implements a Model Context Protocol (MCP) server that acts as an intelligent bridge and proxy to Shopify's Storefront API. It uniquely supports `mock.shop` for safe development and testing without requiring real store credentials.
Last updated: N/A
What is Shopify MCP Proxy & Mock Server?
This is a Shopify Model Context Protocol (MCP) server designed to act as a bridge and proxy for the Shopify Storefront API. It prioritizes safety by integrating with mock.shop for development and testing without requiring real store credentials and communicates via Standard Input/Output (stdio).
How to use Shopify MCP Proxy & Mock Server?
To use this server, clone the repository, install dependencies, and build the server. Configure your MCP client (Cursor, Claude Desktop) to launch this server via stdio, providing the path to the built server. Optionally, configure environment variables for connecting to a real Shopify store.
Key features of Shopify MCP Proxy & Mock Server
Safe development and testing with mock.shop
Transparency and control over Shopify API interactions
Support for Standard Input/Output (stdio) communication
Provides ToolAnnotations for API action impact
Offers a safe execution engine tailored for Shopify development workflows
Use cases of Shopify MCP Proxy & Mock Server
Developing Shopify applications with AI assistance
Testing Shopify API integrations without affecting live stores
Understanding the impact of API actions before execution
Building reliable and transparent Shopify development workflows
FAQ from Shopify MCP Proxy & Mock Server
How do I connect to a real Shopify store?
How do I connect to a real Shopify store?
Set the SHOPIFY_STORE and SHOPIFY_ACCESS_TOKEN environment variables before running the server.
Do I need to configure anything to use mock.shop?
Do I need to configure anything to use mock.shop?
No, using mock.shop is the default behavior when SHOPIFY_STORE is not set.
How do I verify the server is built correctly?
How do I verify the server is built correctly?
Use the npm run inspect command to see the server's advertised capabilities.
Why are images not rendering inline in Claude Desktop or Cursor?
Why are images not rendering inline in Claude Desktop or Cursor?
Clients like Claude Desktop and Cursor currently render ImageContentBlocks in a separate UI block below the main text response.
Are Admin API tools supported?
Are Admin API tools supported?
Admin API tools are planned for future updates but are currently disabled.