🛍️ Commerce Cloud MCP Server

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

✨ 特性

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

🔄 流程图

🚀 安装指南

先决条件

• Node.js版本22或更高
• Git
• 具有OCAPI访问权限的Salesforce Commerce Cloud实例
• 一个MCP客户端应用（如Claude桌面应用）

安装步骤

1. 克隆仓库：

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

2. 安装依赖：

npm install

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

cp .env.example .env

用您的Salesforce Commerce Cloud凭证编辑.env文件。

4. 构建项目：

npm run build

5. 导入OCAPI配置：

   OCAPI配置文件位于data/ocapi目录下。将其导入到您的SFCC业务管理器中：

   • 登录业务管理器
   • 导航至管理 > 站点开发 > 开放商业API设置
   • 对于data/ocapi目录中的每个JSON文件：
     • 选择适当的API类型（商店/数据）
     • 复制JSON文件的内容
     • 粘贴到配置字段
     • 点击“保存”

   这些配置使必要的端点能够支持MCP服务器的功能。

6. 配置您的MCP客户端应用（示例 - Claude桌面应用）：

   • 打开Claude桌面应用
   • 转到文件 > 设置 > 开发者 > 编辑配置
   • 这将打开包含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
• 开放商业API

📄 许可证

本项目采用MIT许可证 - 查看LICENSE文件以获取详细信息。

👥 致谢

比我更聪明的人创造了使这个项目成为可能的工具。我想提到这些项目

• colinhacks 的 (zod）。
• Egoist 的 (tsup）。

希望您会发现这个工具很有用！🌟

由 Brinsil 制作 ❤️。