SAP Commerce MCP Server

- Product Search: Search through products using natural language queries
- Advanced Search: Filter products by category, price range, and more
- Product Details: Get detailed information about specific products
- Stock Availability: Check product stock levels and availability
- Categories: Browse and search products by categories
- Promotions: Get information about active promotions
- Reviews: Access product reviews and ratings
- Product Suggestions: Get personalized product recommendations
- Cart Management: Full shopping cart operations support
- Health Monitoring: Real-time service health tracking
- Performance Analytics: Historical performance analysis and insights

The server can be configured using environment variables:

SAP_COMMERCE_URL=https://your-commerce-url/occ/v2
SAP_COMMERCE_SITE=your-site-name
SAP_COMMERCE_TIMEOUT=10000
SAP_COMMERCE_VALIDATE_SSL=false
SAP_COMMERCE_CLIENT_ID=your-client-id

SAP_COMMERCE_CLIENT_SECRET=your-client-secret
LOG_LEVEL=info # debug, info, warn, or error

For development, you can use:

npm run dev

This will start TypeScript in watch mode, recompiling on changes.

The server supports OAuth2 client credentials flow for authenticated requests to SAP Commerce. Configure the client ID and secret in the environment variables to enable authenticated requests.

1. search-products: Basic product search with pagination support
- Parameters:
- query: Search query string
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page

2. search-products-advanced: Advanced product search with filters
- Parameters:
- query: (Optional) Search query string
- categoryCode: (Optional) Category code filter
- minPrice: (Optional) Minimum price filter
- maxPrice: (Optional) Maximum price filter
- sort: (Optional) Sort order
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page

3. get-product-details: Get detailed product information
- Parameters:
- productCode: Product code/SKU

4. check-product-availability: Check product stock levels
- Parameters:
- productCode: Product code/SKU
- location: (Optional) Warehouse/store location code

5. get-categories: Browse product categories
- Parameters:
- categoryId: (Optional) Specific category ID

6. get-products-by-category: Get products in a category
- Parameters:
- categoryId: Category ID
- currentPage: (Optional) Page number
- pageSize: (Optional) Results per page
- sort: (Optional) Sort order

7. get-promotions: Get promotion information
- Parameters:
- promotionId: (Optional) Specific promotion ID

8. get-product-reviews: Get product reviews
- Parameters:
- productCode: Product code/SKU

9. get-product-suggestions: Get product recommendations
- Parameters:
- productCode: Reference product code/SKU
- maxResults: (Optional) Maximum number of suggestions

10. create-cart: Create a new shopping cart
- Parameters: None

11. get-cart: Get cart details
- Parameters:
- cartId: Cart ID to retrieve

12. add-to-cart: Add a product to cart
- Parameters:
- cartId: Cart ID
- productCode: Product code/SKU
- quantity: (Optional) Quantity to add (default: 1)

13. update-cart-entry: Update product quantity in cart
- Parameters:
- cartId: Cart ID
- entryNumber: Entry number in cart
- quantity: New quantity

14. remove-from-cart: Remove a product from cart
- Parameters:
- cartId: Cart ID
- entryNumber: Entry number to remove

15. get-order-status: Check order status
- Parameters:
- orderId: Order ID

16. get-order-history: View order history
- Parameters:
- userId: User ID

17. check-service-health: Get current service health status
- Parameters: None

18. analyze-performance: Get historical performance insights
- Parameters: None