================== /// MCP /// /// DEV /// ================== [server:online] [protocol:ready]
dev-mcp
by Shopify
Shopify.dev Model Context Protocol (MCP) server and CLI that exposes tools for Shopify Admin GraphQL, Functions and optional Polaris docs.
436
46
Enterprise01
learn_shopify_api
Teaches the LLM about supported Shopify APIs and how to use this MCP server’s tools, providing up-to-date instructions and a conversation ID.
02
search_docs_chunks
Searches across all shopify.dev documentation chunks to find content matching a query.
03
fetch_full_docs
Retrieves the complete, unchunked documentation for specific shopify.dev paths when the exact path is known.
04
introspect_graphql_schema
Explores Shopify GraphQL schemas to locate types, queries, and mutations that match given search terms.
05
validate_graphql_codeblocks
Validates GraphQL code blocks against a chosen Shopify GraphQL schema to catch hallucinated fields or operations.
Installation
1. Prerequisites
• Node.js ≥18
• pnpm or npm (pnpm is commonly used at Shopify, substitute with npm/yarn if the project supplies corresponding lock-files)
• A POSIX shell (macOS/Linux or Windows WSL)
2. Clone the repository
git clone https://github.com/Shopify/dev-mcp.git
cd dev-mcp
3. Install dependencies
pnpm install # or: npm ci
4. Project configuration
• Copy the example environment file if it exists.
• Open .env and fill in required values (e.g. OPENAI_API_KEY, SHOPIFY_API_TOKEN, PORT). Consult the README for the exact variable list.
cp .env.example .env
5. Build TypeScript
pnpm run build # or: npm run build
6. Start the server
# Development (auto-reload)
pnpm run dev # usually invokes ts-node-dev / nodemon
# Production
node dist/index.js # or: pnpm start / npm start
7. Verify
curl http://localhost:3000/health # should return 200 OK or {status:"ok"}
Docker (optional)
docker build -t dev-mcp .
docker run -p 3000:3000 --env-file .env dev-mcp
Documentation
License: ISC License
Updated 7/30/2025