SFCC MCP Server

SFCC MCP Server

site icon
2025.04.08 4
TypeScriptSFCC API 交互模型上下文协议动态端点注册开发效率其它
SFCC MCP Server 是一个用于与 Salesforce Commerce Cloud (SFCC) API 交互的模型上下文协议 (MCP) 服务器。它提供了动态端点注册、自动处理路径和查询参数、OCAPI 认证等功能,支持所有 SFCC GET Data API 端点。
View on GitHub

Overview

基本能力

产品定位

SFCC MCP Server 是一个用于与 Salesforce Commerce Cloud (SFCC) API 交互的模型上下文协议 (MCP) 服务器。

核心功能

  • 基于 endpoints.json 配置的动态端点注册
  • 自动处理路径和查询参数
  • 使用客户端凭证流进行 OCAPI 认证
  • 支持所有 SFCC GET Data API 端点

适用场景

  • 需要与 SFCC API 交互的开发项目
  • 自动化 SFCC 数据访问和管理
  • 构建自定义 SFCC 集成工具

工具列表

  • catalogs_by_id_products:用于访问特定目录下的产品
  • 其他工具名称根据端点路径自动生成

常见问题解答

  1. 如何配置 OCAPI 认证?
  2. 在 SFCC Business Manager 中配置 API 客户端,设置 OAuth 客户端 ID 和密钥,并分配适当的角色。
  3. 如何添加新的端点?
  4. src/endpoints.json 文件中配置新的端点路径和参数。

使用教程

使用依赖

# Install dependencies
npm install

安装教程

# Build the server
npm run build

调试方式

# Start the server
node build/index.js

配置

创建 .env 文件并设置以下变量:

# SFCC API Configuration
SFCC_API_BASE=https://your-instance.api.commercecloud.salesforce.com/
SFCC_SITE_ID=your_site_id  # optional, defaults to "RefArch"

# Admin API Credentials (Client credentials flow)
SFCC_ADMIN_CLIENT_ID=your_admin_client_id
SFCC_ADMIN_CLIENT_SECRET=your_admin_client_secret

许可证

该项目遵循 MIT 开源许可条款。