Shopify多租户OAuth服务

一个无头、生产就绪的Shopify模型上下文协议(MCP)服务器,作为桥梁,允许AI代理通过标准化API管理多个Shopify商店。

  • by Shakhawat001
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 Shakhawat001/shopify-mcp

使用说明

Shopify MCP服务器(OAuth+多租户)

无头,生产就绪 模型上下文协议(MCP) Shopify服务器。 它起到了桥梁的作用,允许AI代理(n8n、Claude Desktop、Cursor)通过标准化的API管理多个Shopify商店。

✨ 特性

  • 系统级OAuth:作为真正的Shopify应用程序安装在多个商店。
  • 多租户:使用单个服务器实例管理不同的商店。
  • 双重运输:支持两者 流式HTTP (推荐)和 上海证券交易所 (遗产)。
  • 安全:受承载令牌和系统标头保护。
  • 嵌入式仪表板:在Shopify Admin中查看时,包括一个有用的UI。
  • Docker就绪:针对端口上的Coolify/Portainer部署进行了优化 38383.

🚀 快速开始

1.代理商/开发商

🤖 你是AI特工吗? 阅读 AI_CONEXT.md 了解完整的架构细节、代码映射和设计约束。

2.部署(Coolify)

  1. 部署此仓库。
  2. 设置环境变量:
    • HOST:您的公共URL(例如。 https://mcp.mydomain.com)
    • SHOPIFY_API_KEY: a287cff4169d717d453125de7e90a361 (默认)
    • SHOPIFY_API_SECRET:(来自合作伙伴仪表板)
    • MCP_SERVER_TOKEN:(您的密码)
  3. 访问您的URL查看仪表板!

🔗 连接客户

流式HTTP(建议用于n8n)

  • 统一资源定位符: https://your-server.com/mcp
  • 方法:POST
  • 认证: Authorization: Bearer <MCP_SERVER_TOKEN>
  • 上下文: X-Shopify-Domain: <shop-domain>

SSE(传统)

  • 统一资源定位符: https://your-server.com/sse
  • 认证: Authorization: Bearer <MCP_SERVER_TOKEN>
  • 上下文: X-Shopify-Domain: <shop-domain>

🛠 技术栈

  • Node.js和TypeScript
  • Express和MCP SDK(流式HTTP+SSE)
  • @shopify/shopify-api