🛍️ Commerce Cloud MCP Server

🛍️ Commerce Cloud MCP Server

一个帮助将 AI 应用连接到 Salesforce Commerce Cloud 的服务。它使用模型上下文协议（MCP），在 AI 客户端应用与 Commerce Cloud 实例之间交换数据。

✨ 功能

• 🛍️ 产品管理与更新
• 📊 订单分析与洞察
• 🗂️ 自定义对象操作
• 📄 内容资源管理
• ⚙️ 基于环境的配置

🔄 流程图

🚀 设置说明

前置条件

• Node.js 版本 22 或更高
• Git
• 可访问 OCAPI 的 Salesforce Commerce Cloud 实例
• MCP 客户端应用（例如 Claude Desktop App）

安装步骤

1. 克隆仓库：

git clone https://github.com/your-username/commercecloud-mcp-server.git
cd commercecloud-mcp-server

2. 安装依赖项：

npm install

3. 创建并配置环境文件：

cp .env.example .env

编辑 .env 文件，填写 Salesforce Commerce Cloud 凭据。

4. 构建项目：

npm run build

5. 导入 OCAPI 配置：

   OCAPI 配置文件位于 data/ocapi 目录中。将它们导入 SFCC Business Manager：

   • 登录 Business Manager
   • 前往 Administration > Site Development > Open Commerce API Settings
   • 对于 data/ocapi 目录中的每个 JSON 文件：
     • 选择相应的 API 类型（Shop/Data）
     • 复制 JSON 文件的内容
     • 粘贴到配置字段中
     • 点击“Save”

   这些配置会启用 MCP 服务正常运行所需的端点。

6. 配置 MCP 客户端应用（示例：Claude Desktop App）：

   • 打开 Claude Desktop App
   • 前往 File > Settings > Developer > Edit Config
   • 这会打开一个包含 claude_desktop_config.json 文件的文件夹
   • 在编辑器中打开该文件，并添加服务详情：

{
  "mcpServers": {
    "commercecloud": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/commercecloud-mcp-server/dist/index.js"]
    }
  }
}

注意：将 /ABSOLUTE/PATH/TO/ 替换为项目文件夹的实际路径。

📋 使用场景

使用场景名称	描述	实现状态
产品详情	从 Commerce Cloud 获取产品信息	✅ 现已支持
产品更新	根据图片生成产品描述并自动更新产品详情	✅ 现已支持
订单详情	分析订单模式并了解客户购买行为	✅ 现已支持
自定义对象	读取、写入和创建自定义对象	✅ 现已支持
内容资源	从 Commerce Cloud 获取内容资源	✅ 现已支持
内容更新	根据设计图片生成内容正文并自动更新内容资源	✅ 现已支持
站点首选项	管理特定于站点的配置和首选项	🔄 未来实现
促销与营销活动	管理促销和营销活动	🔄 未来实现
作业配置	管理作业配置	🔄 未来实现

📚 相关文档

• 模型上下文协议（MCP）
• Typescript SDK
• Open Commerce API

📄 许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

👥 致谢

许多比我更出色的人开发了让这个项目得以实现的工具。我想感谢以下项目的开发者：

• colinhacks，感谢其开发的 (zod)。
• Egoist，感谢其开发的 (tsup)

希望你觉得这个工具有用！🌟

由 Brinsil 倾心打造。