Shopify Dev MCP Docker Template

Shopify开发MCP服务器（HTTP流式传输）

Docker化的Shopify.dev MCP服务器，它公开了一个HTTP端点，用于与N8N和其他基于HTTP的客户端集成。

特性

• HTTP流式传输：通过HTTP而不是stdio访问Shopify Dev MCP服务器
• N8N兼容：非常适合连接到N8N工作流
• 可部署云：已准备好部署到数字海洋应用平台
• 自定义HTTP服务器：封装Shopify开发MCP的自定义Node.js服务器
• 实时通信：使用SSE（服务器发送事件）进行流式响应

快速开始

部署到数字海洋

1. 使用Digital Ocean进行身份验证：

   doctl auth init

1. 部署应用程序：

   doctl apps create --spec .do/app.yaml

1. 获取您的应用程序URL:

   doctl apps get  --format Domains

您的MCP服务器将在以下网址提供：

• HTTP流端点: https://your-app-url.do/stream （PUT）-双向流媒体- 推荐
• SSE端点: https://your-app-url.do/sse （GET）-遗留SSE用于回复
• 消息端点: https://your-app-url.do/message （POST）-用于苏格兰和南方能源公司运输
• 健康终点: https://your-app-url.do/health -检查服务器状态

可用工具

此MCP服务器提供对所有Shopify开发工具的访问：

• learn_shopify_api -介绍支持的Shopify API
• search_docs_chunks -在shopify.dev文档中搜索
• fetch_full_docs -检索完整的文档页面
• introspect_graphql_schema -探索Shopify GraphQL模式
• validate_graphql_codeblocks -验证GraphQL代码块
• validate_component_codeblocks -验证Shopify组件代码
• validate_theme_codeblocks -验证Liquid代码块（部分模式）
• validate_theme -验证整个主题目录

连接到N8N

部署后，配置N8N以连接到MCP服务器：

1. 获取已部署的应用程序URL （例如。， https://shopify-mcp-server-xyz.ondigitalocean.app)

1. 在N8N中添加MCP服务器配置：

- 服务器URL: https://your-app-url/sse - 协议：HTTP - 传输：SSE（服务器发送事件）

1. 使用可用的工具 在N8N工作流中

环境变量

您可以在Digital Ocean中配置以下环境变量：

• PORT -端口号（默认值：8080）-已配置
• API_KEY -（可选）用于身份验证的API密钥。如果未设置，服务器将在没有身份验证的情况下运行
• OPT_OUT_INSTRUMENTATION -设置为“true”以禁用Shopify Dev MCP遥测
• LIQUID_VALIDATION_MODE -设置为“完整”（默认）或“部分”

认证

服务器支持可选的API密钥身份验证，通过：

1. 认证头: Authorization: Bearer
2. 查询参数: ?apiKey=

使用auth的示例：

# Using Authorization header
curl -H "Authorization: Bearer your-api-key" \
  https://your-app-url/sse

# Using query parameter (for SSE)
curl https://your-app-url/sse?apiKey=your-api-key

地方发展

使用Node.js在本地运行：

npm start

或者使用Docker：

docker build -t shopify-dev-mcp .
docker run -p 8080:8080 -e PORT=8080 shopify-dev-mcp

连接到：

• 上海证券交易所 http://localhost:8080/sse -订阅MCP回复
• 留言： http://localhost:8080/message -发送MCP请求
• 健康： http://localhost:8080/health -检查状态

建筑

N8N/Client → HTTP → Custom HTTP Server → stdio → Shopify Dev MCP
                         (Node.js)         (Port 8080)

自定义Node.js服务器：

1. 将Shopify Dev MCP服务器作为子进程生成
2. 将stdio通信连接到HTTP端点
3. 通过HTTP实现JSON-RPC 2.0协议
4. 使用SSE进行实时流式响应
5. 处理多个客户端之间的消息路由