用于Shopify的MCP代理服务器和Mock Server（ShopifyMCPMockShop）

该项目实现了一个模型上下文协议（MCP）服务器，充当智能桥接器和代理，连接到Shopify的Storefront API。它独有的功能是支持mock.shop，以便在不使用真实商店凭证的情况下进行安全开发和测试。

该服务器通过**标准输入输出(stdio)**进行通信，使其适合与Claude Desktop和Cursor等客户端本地集成。

动机

通用AI开发者工具和现成的MCP服务器通常承诺很多，但可能缺乏透明度、安全机制（如显式的ToolAnnotations）、稳定性或特定功能，特别是在开发环境中。因此，该项目旨在解决这些问题，并为用户提供一个可靠且易于使用的解决方案。

项目文档翻译

以下是上述内容的完整中文翻译：

Shopify MCP 代理服务器和 Mock Server（ShopifyMCPMockShop）

该项目实现了一个模型上下文协议（MCP）服务器，充当智能桥接器和代理，连接到 Shopify 的 Storefront API。它独有的功能是支持 mock.shop，以便在不使用真实商店凭证的情况下进行安全开发和测试。

该服务器通过 标准输入输出 (stdio) 进行通信，使其适合与 Claude Desktop 和 Cursor 等客户端本地集成。

动机

通用 AI 开发者工具和现成的 MCP 服务器通常承诺很多，但可能缺乏透明度、安全机制（如显式的 ToolAnnotations）、稳定性或特定功能，特别是在开发环境中。因此，该项目旨在解决这些问题，并为用户提供一个可靠且易于使用的解决方案。

特性和功能

核心特性

1. MCP 服务器实现：作为 MCP 协议的代理和桥接器，支持与各种客户端和服务集成。
2. Mock 支持：通过 mock.shop 提供模拟环境，便于开发和测试。
3. stdio 通信：使用标准输入输出进行通信，确保兼容性和易用性。

功能模块

• Storefront API 集成：支持与 Shopify 的 Storefront API 进行交互。
• Mock 环境配置：提供模拟数据和环境设置，便于开发人员测试和验证功能。
• 扩展插件架构：允许用户添加自定义插件和扩展，增强服务器的功能。

安装与使用

安装步骤

1. 克隆项目仓库：

   git clone https://github.com/yourusername/shopify-mcp-mock-server.git
   

2. 安装依赖项：

   npm install
   

3. 启动服务器：

   npm start
   

使用示例

1. 创建商店信息请求：

   const response = await fetch('http://localhost:3000', {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       toolName: 'getShopInfo'
     })
   });
   

2. 配置 Mock 环境：

   // 在项目根目录创建 mock-config.js 文件
   module.exports = {
     shopUrl: 'mock-shop.shop',
     apiKey: 'your-mock-api-key',
     collections: [
       { id: 1, name: 'Mock Collection' },
       // 其他模拟数据...
     ]
   };
   

相关工具

核心工具

• getShopInfo：获取商店的基本信息（名称、描述、货币）。
• findProducts：搜索/过滤产品，支持分页和排序。
• getProductById：根据 ID 获取特定产品。
• cartCreate：创建新的购物车。

扩展工具

• adminGetCustomerById：通过 Admin API 根据 ID 获取客户信息（计划中）。
• adminCreateProduct：通过 Admin API 创建新产品（计划中）。

测试与验证

快速测试

1. 启动服务器：

   npm start
   

2. 发送请求到 http://localhost:3000，例如使用 Postman 或 curl：

   curl -X POST http://localhost:3000 \
     -H "Content-Type: application/json" \
     -d '{"toolName": "getShopInfo"}'
   

验证结果

服务器应返回 JSON 格式的响应，包含工具名称和相关数据。例如：

{
  "toolName": "getShopInfo",
  "shopName": "Mock Shop",
  "description": "A mock shop for development purposes.",
  "currencyCode": "USD"
}

扩展与计划

计划中的功能

1. Admin API 支持：实现对 Shopify Admin API 的支持，包括客户管理和产品创建。
2. 插件系统：开发一个可扩展的插件架构，允许用户添加自定义逻辑和功能。
3. 高级模拟：提供更复杂的模拟场景，如动态数据生成和错误处理。

未来更新

• 支持更多 Shopify API 功能。
• 提供图形化界面进行服务器配置和管理。
• 增强安全性和性能优化。

贡献与支持

如何贡献

1. 叉仓库：

   git clone https://github.com/yourusername/shopify-mcp-mock-server.git
   cd shopify-mcp-mock-server
   

2. 创建功能分支：

   git checkout -b feature/new-feature
   

3. 提交更改并创建拉取请求。

获取支持

• 邮件：support@shopify.com
• GitHub Issues：Issues 链接

希望以上翻译对您有所帮助！如果需要进一步的说明或代码示例，请随时告知。