Sfcc MCP Server

🚀 SFCC MCP サーバー

Salesforce コマースクラウド (SFCC) API とのインタラクションに使用するモデルコンテキストプロトコル (MCP) サーバーです。

✨ 主な機能

• endpoints.json 設定ファイルに基づいたエンドポイントの動的登録
• パスとクエリパラメータの自動処理
• クライアント資格情報フローを使用した OCAPI 認証
• すべての SFCC GET データ API エンドポイントのサポート

📦 インストール

# 依存関係のインストール
npm install

# サーバーのビルド
npm run build

📚 設定

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の変数を追加します。

# SFCC API 設定
SFCC_API_BASE=https://your-instance.api.commercecloud.salesforce.com/

# 管理 API 資格情報（クライアント資格情報フロー）
SFCC_ADMIN_CLIENT_ID=your_admin_client_id
SFCC_ADMIN_CLIENT_SECRET=your_admin_client_secret

📚 OCAPI 設定

SFCC データ API を使用するには、適切な権限を持つ API クライアントを SFCC で設定する必要があります。

API クライアント

1. SFCC アカウントマネージャーで、API クライアントに移動します。
2. 新しい API クライアントを作成するか、既存のクライアントを編集します。
3. OAuth 設定を構成します。
   • OAuth クライアント ID：(あなたのクライアント ID)
   • OAuth クライアントシークレット：(あなたのクライアントシークレット)
   • デフォルトスコープ：必要なスコープを含めます。
   • トークンエンドポイント認証方法：client_secret_post
4. API クライアントロールを構成します。
   • 必要なデータにアクセスするための適切な権限を割り当てます。

ビジネスマネージャー

1. SFCC ビジネスマネージャーで、管理 > サイト開発 > オープンコマース API 設定に移動します。
2. ocapi-bm-config.json を参照して設定例を確認します。

📚 MCP 設定（VSCode 用）

1. コマンドパレット (Ctrl/Cmd + Shift + P) を開きます。
2. "MCP" と入力し、MCP: サーバーを追加... を選択します。
3. Command (stdio) 手動インストール を選択します。
4. コマンドフィールドに node <full-path-to-your>/build/index.js を入力します（提出前にパスのプレースホルダーを置き換えてください）。
5. MCP に名前を付けます（例："sfcc"）。
6. ユーザーまたはワークスペースを選択して設定します。

これにより、ユーザーの settings.json またはワークスペースの .vscode/mcp.json に新しい MCP 定義が作成されます。

{
    "servers": {
        "sfcc": {
            "type": "stdio",
            "command": "node",
            "args": [
                "<full-path-to-your>/build/index.js"
            ]
        }
    }
}

これで、MCP: サーバーを一覧表示 コマンドでサーバーを監視、起動、再起動、または停止できます。ツールを使用する際は、GitHub Copilot Chat の プロキシ モードに切り替えてください。

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します。

node build/index.js

📚 エンドポイント設定

エンドポイントは src/endpoints.json で設定され、各エンドポイントは以下の構造を持ちます。

• パス：API リクエストのパス
• 説明：エンドポイントの説明情報
• パラメータ：パラメータ名、タイプ、および必須かどうかの情報を含む

📚 ツール命名規則

ツール名は、パスを特定の形式に変換し、64 文字以内に切り捨てて生成されます。同時に、数字のサフィックスを使用して一意性を確保します。

📄 ライセンス

このプロジェクト全体は MIT ライセンスの下で提供されており、コードの自由な使用、変更、および配布が許可されています。