shopify-python-mcp-server by A-baoYang - MCP Server

Shopify MCP Server - Python Implementation

This is a Python implementation of the Shopify MCP Server using FastMCP. It provides the same functionality as the original TypeScript version, helping developers interact with Shopify APIs through the Model Context Protocol.

Inspired by shopify.dev mcp server

Features

Admin GraphQL API support with schema introspection and validation
Documentation search across shopify.dev
GraphQL code validation to prevent hallucinated fields
Conversation tracking for usage analytics
Schema caching for improved performance

Installation

# Clone the repository
git clone https://github.com/A-baoYang/shopify-python-mcp-server
cd shopify-mcp-server

# Install dependencies using uv
uv pip install -r requirements.txt

# Or install with pip
pip install -r requirements.txt

Usage

Running the server

# Using uv
uv run python main.py

# Or with Python directly
python main.py

Configuration for Claude Desktop or Cursor

Add the following to your MCP configuration:

{
  "mcpServers": {
    "shopify-mcp-server": {
      "command": "python",
      "args": ["/path/to/shopify-mcp-server/main.py"]
    }
  }
}

With uv:

{
  "mcpServers": {
    "shopify-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "/path/to/shopify-mcp-server/main.py"]
    }
  }
}

Environment Variables

OPT_OUT_INSTRUMENTATION: Set to "true" to disable usage tracking
POLARIS_UNIFIED: Set to "true" or "1" to enable Polaris support
LIQUID_MCP: Set to "true" or "1" to enable Liquid support (experimental)
DEV: Set to "true" to use development Shopify URL

Available Tools

Tool Name	Description
`learn_shopify_api`	Start here first - Teaches about Shopify APIs and generates required conversationId
`search_docs_chunks`	Search across shopify.dev documentation
`fetch_full_docs`	Retrieve complete documentation pages
`introspect_graphql_schema`	Explore GraphQL schemas to find types, queries, and mutations
`validate_graphql_codeblocks`	Validate GraphQL code against schema

Available Prompts

Prompt Name	Description
`shopify_admin_graphql`	Help write GraphQL operations for the Shopify Admin API

Development

The project structure:

shopify-mcp-server/
--- main.py              # Main server entry point
--- src/
|   --- settings.py      # Configuration settings
|   --- types.py         # Type definitions
|   --- tools/           # Tool implementations
|   --- validations/     # Validation logic
|   --- utils/           # Utility functions
--- data/                # Schema cache directory