🚀 Salesforce Commerce Cloud (SFCC) Logs MCP Server

A production-grade Model Context Protocol (MCP) server that enables AI coding assistants (Claude Desktop, Cursor, Gemini, Claude Code, VS Code Copilot, Windsurf, etc.) to query, tail, search, analyze, and clean Salesforce Commerce Cloud (SFCC / Demandware) logs in real-time over standard I/O (stdio).

✨ Key Features

• 🔄 Context-Aware Dynamic Workspace Resolution: Automatically detects the active workspace folder sent during the MCP initialization handshake and walks up the directory tree to find dw.json or .env. Switch between client projects or sandbox environments seamlessly without restarting your MCP server or changing settings.

• ⚡ Bandwidth-Optimized Range Chunking: Uses HTTP Range headers (bytes=-1MB) over WebDAV to fetch only the trailing chunk of huge log files. Tail multi-gigabyte production logs in milliseconds with minimal bandwidth consumption.

• 🔍 Multi-File Search & Filtering: Perform case-insensitive regex/text searches across multiple log files filtered by log level (error, warn, info, debug) or target date (YYYYMMDD or today).

• ⏱️ SFCC Background Job Analytics: Dedicated toolset to inspect cron job logs (job-*), filter entries by severity, and parse step boundaries to construct visual execution timelines (RUNNING, OK, ERROR).

• 📊 Statistical Log Volume Summaries: Generate high-level audits breaking down active log volume, category distributions, file counts, and newest active files for any given date.

• 🧹 Log Sanitization: Clean or reset active log files directly from chat to isolate freshly reproduced bugs.

Related MCP server: Local Logs MCP Server

📦 Installation

Global Installation (Recommended)

Install globally to make the sfcc-logs-mcp binary available everywhere in your PATH:

npm install -g sfcc-logs-mcp

Once installed globally, you can run:

sfcc-logs-mcp
# or shorthand alias
sfcc-logs

Run on Demand (npx)

npx sfcc-logs-mcp

🔐 Authentication & Credential Discovery

The server resolves credentials in the following order of priority:

1. dw.json (Standard SFCC Tooling Config)

Place a dw.json file in your workspace root (or any parent directory):

{
  "hostname": "your-sandbox.demandware.net",
  "username": "your_webdav_username",
  "password": "your_webdav_password",
  "webdav_path": "/on/demandware.servlet/webdav/Sites/Logs"
}

2. .env File

Alternatively, define credentials in a local .env file in your project folder:

SFCC_SERVER=your-sandbox.demandware.net
SFCC_USERNAME=your_webdav_username
SFCC_PASSWORD=your_webdav_password
SFCC_WEBDAV_PATH=/on/demandware.servlet/webdav/Sites/Logs

3. Environment Variables

Set system environment variables for static single-instance configurations:

DW_WEBDAV_USERNAME=your_webdav_username
DW_WEBDAV_PASSWORD=your_webdav_password
SFCC_SERVER=your-sandbox.demandware.net

🛠️ MCP Tools Reference

🔌 Connecting to AI Clients

Claude Desktop

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sfcc-logs": {
      "command": "sfcc-logs-mcp"
    }
  }
}

Cursor IDE

Add to .cursor/mcp.json in your workspace or global Cursor settings:

{
  "mcpServers": {
    "sfcc-logs": {
      "command": "sfcc-logs-mcp"
    }
  }
}

Windsurf / VS Code / Other MCP Clients

Configure the stdio server using the globally installed binary:

{
  "mcpServers": {
    "sfcc-logs": {
      "command": "npx",
      "args": ["-y", "sfcc-logs-mcp"]
    }
  }
}

🧪 Testing with MCP Inspector

You can test and verify all tools interactively using the official @modelcontextprotocol/inspector:

# 1. Interactive Web UI
npx @modelcontextprotocol/inspector sfcc-logs-mcp

# 2. CLI Mode (List tools)
npx @modelcontextprotocol/inspector --cli sfcc-logs-mcp --method tools/list

# 3. CLI Mode (Call a tool)
npx @modelcontextprotocol/inspector --cli sfcc-logs-mcp --method tools/call --tool-name get_latest_error

# 4. Interactive Terminal UI (TUI)
npx @modelcontextprotocol/inspector --tui sfcc-logs-mcp

👨‍💻 Development & Contributing

# Clone the repository
git clone https://github.com/nabhat/sfcc-logs-mcp.git
cd sfcc-logs-mcp

# Install dependencies
npm install

# Run unit tests with Vitest & coverage
npm run test

# Lint the codebase
npm run lint

# Compile TypeScript
npm run build

📒 License

This project is licensed under the MIT License - see the LICENSE.txt file for details.