一台由人工智能驱动的模型上下文协议（MCP）服务器，提供对 Salesforce B2C 商业云开发工具、文档和运行时诊断的全面访问。

✨ 主要特色

• ** 🔍 完整SFCC文档访问** - 搜索和探索所有SFCC API类和方法。
• ** 🏗️ SFRA 文档 ** - 增强对 Storefront 参考架构文档的访问
• ** 🧱 ISML 模板参考** - 完整的 ISML 元素文档，包含示例和使用指导
• ** 📊 日志分析工具** - 针对SFCC实例的实时错误监控、调试和作业日志分析
• ** ⚙️ 系统对象定义** - 探索自定义属性和站点偏好
• ** 🧪 脚本调试器** - 在凭证模式下执行和检查脚本调试器端点，包括非默认商店路由的自定义触发 URL/路径
• ** 🚀 卡带生成** - 自动创建卡带结构，支持工作区绑定路径安全（写入留在工作区根节点内，或当根节点不可用时保留当前工作目录的退回;封锁目录退回被阻止）
• ** 🧩 代理技能引导 ** - 安装或合并代理。

SFCC Development MCP Server

An AI-powered Model Context Protocol (MCP) server that provides comprehensive access to Salesforce B2C Commerce Cloud development tools, documentation, and runtime diagnostics.

✨ Key Features

• 🔍 Complete SFCC Documentation Access - Search and explore all SFCC API classes and methods
• 🏗️ SFRA Documentation - Enhanced access to Storefront Reference Architecture documentation
• 🧱 ISML Template Reference - Complete ISML element documentation with examples and usage guidance
• 📊 Log Analysis Tools - Real-time error monitoring, debugging, and job log analysis for SFCC instances
• ⚙️ System Object Definitions - Explore custom attributes and site preferences
• 🧪 Script Debugger - Execute and inspect script-debugger endpoints in credentialed mode, including custom trigger URLs/paths for non-default storefront routes
• 🚀 Cartridge Generation - Automated cartridge structure creation with workspace-bound path safety (writes stay inside workspace roots, or current working directory fallback when roots are unavailable; home-directory fallback is blocked)
• 🧩 Agent Skill Bootstrap - Install or merge AGENTS.md and bundled skills into the current project or a temp directory for AI assistants
• ✅ Tool Argument Validation - Runtime schema validation enforces required fields, type checks, enum constraints, integer/numeric bounds, and strict unknown-key checks for object schemas (top-level and nested) before handler execution
• ⏱️ MCP Progress + Cancellation - Tool calls honor request cancellation signals and emit out-of-band notifications/progress updates when clients provide a progressToken

🚀 Quick Start

Option 1: Documentation-Only Mode (No SFCC credentials needed)

{
  "mcpServers": {
    "sfcc-dev": {
      "command": "npx",
      "args": ["sfcc-dev-mcp"]
    }
  }
}

Option 2: Full Mode (With SFCC credentials for log and job analysis)

{
  "mcpServers": {
    "sfcc-dev": {
      "command": "npx",
      "args": ["sfcc-dev-mcp", "--dw-json", "/path/to/your/dw.json"]
    }
  }
}

Create a dw.json file with your SFCC credentials. You can use either auth mode (or both):

• Basic auth: username + password
• OAuth: client-id + client-secret
• Optional storefront auth (for script debugger trigger on Basic-Auth storefronts): storefrontUsername + storefrontPassword

{
  "hostname": "your-instance.sandbox.us01.dx.commercecloud.salesforce.com",
  "username": "your-username",
  "password": "your-password",
  "storefrontUsername": "your-storefront-basic-user",
  "storefrontPassword": "your-storefront-basic-password",
  "client-id": "your-client-id",
  "client-secret": "your-client-secret"
}