Hybris MCP

🚀 Hybris MCP Server

このMCP (Model Context Protocol) サーバーは、SAP Commerce Cloud (Hybris) との統合を目的としています。ClaudeなどのAIアシスタントがHybrisインスタンスと対話できるようになります。

✨ 主な機能

• 商品管理：商品を検索し、商品の詳細を取得し、カテゴリを閲覧します。
• 注文管理：注文と注文の詳細を表示します。
• FlexibleSearch：FlexibleSearchクエリを直接実行します。
• Groovyスクリプト：スクリプトコンソールを介してGroovyスクリプトを実行します。
• ImpEx：ImpEx形式を使用してデータをインポートおよびエクスポートします。
• クロンジョブ：クロンジョブを一覧表示し、トリガーします。
• キャッシュ管理：Hybrisのキャッシュをクリアします。
• カタログ同期：カタログの同期をトリガーします。
• ヘルスチェック：システムの健全性を監視します。

📦 インストール

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

📚 ドキュメント

設定

環境変数を使用して設定します。

一般的な設定

標準のHybris (localhost):

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)

プロンプトの例

商品検索

Hybrisで「camera」商品を検索する

FlexibleSearch

FlexibleSearchクエリを実行する: SELECT {pk}, {code}, {name[en]} FROM {Product} WHERE {code} LIKE '%camera%'

Groovyスクリプトの実行

商品を数えるためのこのGroovyスクリプトを実行する:
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のインポート

商品を作成するためのこのImpExをインポートする:
INSERT_UPDATE Product; code[unique=true]; name[lang=en]; catalogVersion(catalog(id),version)
; testProduct001 ; Test Product ; electronicsProductCatalog:Online

カタログ同期のトリガー

StagedからOnlineへのelectronicsカタログを同期する

セキュリティに関する注意事項

• 資格情報を安全に保管し、バージョン管理にコミットしないでください。
• 環境変数または安全なシークレット管理を使用してください。
• サーバーは管理ツールに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