Commerce Cloud MCP 服务器

Commerce Cloud MCP Server 是一个帮助将AI应用程序与Salesforce Commerce Cloud连接的服务器,使用Model Context Protocol (MCP)实现AI客户端应用与Commerce Cloud实例之间的数据交换。

  • by brinzl
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 BrinsilElias/commercecloud-mcp-server

使用说明

🛍️ 商务云MCP服务器

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

✨ 特性

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

🔄 流程图

🚀 安装说明

先决条件

  • Node.js 22或更高版本
  • Git
  • 具有OCAPI访问权限的Salesforce Commerce Cloud实例
  • MCP客户端应用程序(如克劳德桌面应用程序)

安装步骤

  1. 克隆存储库:
git clone https://github.com/your-username/commercecloud-mcp-server.git
cd commercecloud-mcp-server
  1. 安装依赖项:
npm install
  1. 创建并配置您的环境文件:
cp .env.example .env

编辑 .env 使用您的Salesforce Commerce Cloud凭据创建文件。

  1. 构建项目:
npm run build
  1. 导入OCAPI配置:

    OCAPI配置文件位于 data/ocapi 目录。将它们导入SFCC业务经理:

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

    这些配置使MCP服务器能够运行所需的端点。

  2. 配置您的MCP客户端应用程序(示例-克劳德桌面应用程序):

    • 打开克劳德桌面应用程序
    • 转到“文件”>“设置”>“开发人员”>“编辑配置”
    • 这将打开一个包含文件的文件夹 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获取内容资产 ✅ 现在支持
内容更新 从设计图像生成内容正文并自动更新内容资产 ✅ 现在支持
站点首选项 管理特定于站点的配置和首选项 🔄 未来实施
促销与活动 管理促销和活动 🔄 未来实施
作业配置 管理作业配置 🔄 未来实施

📚 证明文件

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

👥 鸣谢

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

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

由以下材料制成❤️ 靠近 Brinsil.