MCP Sitecore Server

🚀 Sitecoreのモデルコンテキストプロトコルサーバ

このサーバは、Sitecoreのモデルコンテキストプロトコルを提供し、GraphQL APIや項目サービスAPIなどの機能を実装しています。

🚀 クイックスタート

このサーバをCursor、VS Code、Claudに追加することで、Sitecoreの機能を利用できます。

✨ 主な機能

実装済みのツール

• [x] GraphQL API

  • [x] introspection-grahpql-{schema}: GraphQLスキーマを返します。
  • [x] query-graphql-{schema}: GraphQLクエリを実行します。

• [x] 項目サービスAPI

  • [x] item-service-get-item: IDに基づいて項目を返します。
  • [x] item-service-get-item-children: IDに基づいて項目の子項目を返します。
  • [x] item-service-get-item-by-path: パスに基づいて項目を返します。
  • [x] item-service-create-item: テンプレートIDと親パスを指定して項目を作成します。
  • [x] item-service-edit-item: IDに基づいて項目を編集します。
  • [x] item-service-delete-item: IDに基づいて項目を削除します。
  • [x] item-service-search-items: 項目を検索します。
  • [x] item-service-run-stored-query: 保存されたクエリを実行します。
  • [x] item-service-run-stored-search: 保存された検索を実行します。
  • [x] 複合項目サービスAPI
    • [x] item-service-get-languages: インスタンス内のSitecore言語を返します。
    • [x] item-service-get-item-descendants: IDに基づいて項目の子孫を返します。

• [ ] Sitecore PowerShell

• [ ] Sitecore CLI

リソースリスト

• [x] config: サーバの設定を返します。すべての設定が正しく行われているかを確認するために使用します。

📦 インストール

以下のモデルコンテキストプロトコルサーバをCursor、VS Code、Claudに追加します。

    "Sitecore": {
        "type": "stdio",
        "command": "npx",
        "args": ["@antonytm/mcp-sitecore-server@latest"],
        "env": {
        "TRANSPORT": "stdio",
        "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
        "GRAPHQL_SCHEMAS": "edge,master,core",
        "GRAPHQL_API_KEY": "{6D3F291E-66A5-4703-887A-D549AF83D859}",
        "GRAPHQL_HEADERS": "",
        "ITEM_SERVICE_DOMAIN": "sitecore",
        "ITEM_SERVICE_USERNAME": "admin",
        "ITEM_SERVICE_PASSWORD": "b",
        "ITEM_SERVICE_SERVER_URL": "https://xmcloudcm.localhost/"
        }
    }

環境変数の説明

• TRANSPORT: 使用するトランスポートプロトコル。オプションは stdio または sse です。
• GRAPHQL_ENDPOINT: SitecoreインスタンスのGraphQLエンドポイントURL。
• GRAPHQL_SCHEMAS: GraphQL APIに使用するSitecoreスキーマ。カンマ区切りで指定します。
• GRAPHQL_API_KEY: GraphQLエンドポイントのAPIキー。
• GRAPHQL_HEADERS: GraphQLリクエストに含める追加のヘッダー情報。
• ITEM_SERVICE_DOMAIN: 項目サービスAPIのログインドメイン。デフォルトは sitecore です。
• ITEM_SERVICE_USERNAME: 項目サービスAPIのログインユーザー名。
• ITEM_SERVICE_PASSWORD: 項目サービスAPIのログインパスワード。
• ITEM_SERVICE_SERVER_URL: 項目サービスAPIのベースURL。

🔧 ローカルインストール / 開発

1. リポジトリをクローンします。
2. npm install を実行して依存関係をインストールします。
3. npm run build を実行してプロジェクトをビルドします。
4. npm start を実行してサーバを起動します。