Hybris MCP

🚀 Hybris MCP 服務器

Hybris MCP 服務器是用於 SAP Commerce Cloud（Hybris）集成的 MCP（模型上下文協議）服務器。該服務器允許像 Claude 這樣的 AI 助手與你的 Hybris 實例進行交互。

✨ 主要特性

• 產品管理：搜索產品、獲取產品詳情、瀏覽產品類別
• 訂單管理：查看訂單及訂單詳情
• 靈活搜索：直接執行 FlexibleSearch 查詢
• Groovy 腳本：通過腳本控制檯運行 Groovy 腳本
• ImpEx：使用 ImpEx 格式導入和導出數據
• 定時任務：列出並觸發定時任務
• 緩存管理：清除 Hybris 緩存
• 目錄同步：觸發目錄同步
• 健康檢查：監控系統健康狀況

📦 安裝指南

git clone <repository-url>
cd hybris-mcp
npm install
npm run build

📚 詳細文檔

配置

通過環境變量進行配置：

常見配置

標準 Hybris（本地主機）：

HYBRIS_BASE_URL=https://localhost:9002
HYBRIS_USERNAME=admin
HYBRIS_PASSWORD=nimda

SAP Commerce Cloud（CCv2）：

HYBRIS_BASE_URL=https://backoffice.your-environment.model-t.cc.commerce.ondemand.com
HYBRIS_USERNAME=admin
HYBRIS_PASSWORD=your-password
HYBRIS_HAC_PATH=/hac

自定義站點配置：

HYBRIS_BASE_URL=https://localhost:9002
HYBRIS_USERNAME=admin
HYBRIS_PASSWORD=nimda
HYBRIS_BASE_SITE_ID=yoursite
HYBRIS_CATALOG_ID=yourProductCatalog
HYBRIS_CATALOG_VERSION=Online

使用方法

與 Claude Code 配合使用

使用 CLI 添加 MCP 服務器：

claude mcp add hybris \
  -e HYBRIS_BASE_URL=https://localhost:9002 \
  -e HYBRIS_USERNAME=admin \
  -e HYBRIS_PASSWORD=nimda \
  -- node /path/to/hybris-mcp/dist/index.js

或者手動添加到你的 Claude Code MCP 設置（~/.claude.json 或項目配置）：

{
  "mcpServers": {
    "hybris": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/hybris-mcp/dist/index.js"],
      "env": {
        "HYBRIS_BASE_URL": "https://localhost:9002",
        "HYBRIS_USERNAME": "admin",
        "HYBRIS_PASSWORD": "nimda"
      }
    }
  }
}

與 Claude Desktop 配合使用

添加到你的 Claude Desktop 配置（macOS 上為 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "hybris": {
      "command": "node",
      "args": ["/path/to/hybris-mcp/dist/index.js"],
      "env": {
        "HYBRIS_BASE_URL": "https://localhost:9002",
        "HYBRIS_USERNAME": "admin",
        "HYBRIS_PASSWORD": "nimda"
      }
    }
  }
}

可用工具

產品與目錄（OCC API）

訂單（OCC API）

管理（HAC）

示例提示

搜索產品

Search for "camera" products in Hybris

靈活搜索

Run a FlexibleSearch query: SELECT {pk}, {code}, {name[en]} FROM {Product} WHERE {code} LIKE '%camera%'

執行 Groovy 腳本

Execute this Groovy script to count products:
import de.hybris.platform.core.Registry
def ctx = Registry.getApplicationContext()
def flexibleSearchService = ctx.getBean("flexibleSearchService")
def query = "SELECT COUNT(*) FROM {Product}"
def result = flexibleSearchService.search(query)
println "Total products: ${result.result[0]}"

導入 ImpEx

Import this ImpEx to create a product:
INSERT_UPDATE Product; code[unique=true]; name[lang=en]; catalogVersion(catalog(id),version)
; testProduct001 ; Test Product ; electronicsProductCatalog:Online

觸發目錄同步

Sync the electronics catalog from Staged to Online

安全注意事項

• 安全存儲憑證 - 切勿將其提交到版本控制中
• 使用環境變量或安全的密鑰管理
• 服務器的管理工具需要 HAC 管理員權限
• 如果只需要 OCC API 訪問權限，可以考慮使用只讀憑證

開發

# 開發模式下的監聽模式
npm run dev

# 構建
npm run build

# 直接運行
HYBRIS_BASE_URL=https://localhost:9002 \
HYBRIS_USERNAME=admin \
HYBRIS_PASSWORD=nimda \
npm start

故障排除

連接問題

1. 驗證你的 Hybris 實例是否正在運行且可訪問
2. 檢查 HAC 是否啟用並可在配置的路徑下訪問
3. 確保憑證具有 HAC 管理員訪問權限

SSL 證書錯誤

對於使用自簽名證書的本地開發：

NODE_TLS_REJECT_UNAUTHORIZED=0 node dist/index.js

CSRF 令牌錯誤

服務器會自動處理 CSRF 令牌。如果你遇到 CSRF 錯誤：

1. 手動檢查 HAC 登錄是否正常
2. 驗證 HAC 路徑是否正確
3. 嘗試重啟 MCP 服務器以獲取新的會話

📄 許可證

MIT