[{"_1":2,"_341":-5,"_342":-5},"loaderData",{"_3":4,"_22":23,"_222":223},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",18046839,"membership","referenceId","0199d013-274b-71c7-9a22-d23226418aee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_138":139,"_220":221},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Provides comprehensive access to Salesforce B2C Commerce Cloud development tools including SFCC API documentation, best practices guides, log analysis, and system object definitions. Enables AI assistants to help with SFCC development tasks through both documentation-only mode and full credential-based mode.","name","SFCC Development MCP Server","readme","# SFCC Development MCP Server\n\n[![npm version](https://badge.fury.io/js/sfcc-dev-mcp.svg)](https://badge.fury.io/js/sfcc-dev-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nAn AI-powered Model Context Protocol (MCP) server that provides comprehensive access to Salesforce B2C Commerce Cloud development tools, documentation, and best practices.\n\n## ✨ Key Features\n\n- **🔍 Complete SFCC Documentation Access** - Search and explore all SFCC API classes and methods\n- **📚 Best Practices Guides** - Curated development guidelines for cartridges, hooks, controllers, client-side JavaScript, and more \n- **🏗️ SFRA Documentation** - Enhanced access to Storefront Reference Architecture documentation\n- **📊 Log Analysis Tools** - Real-time error monitoring, debugging, and job log analysis for SFCC instances\n- **⚙️ System Object Definitions** - Explore custom attributes and site preferences\n- **🚀 Cartridge Generation** - Automated cartridge structure creation\n\n## 🚀 Quick Start\n\n### Option 1: Documentation-Only Mode (No SFCC credentials needed)\n```json\n{\n \"mcpServers\": {\n \"sfcc-dev\": {\n \"command\": \"npx\",\n \"args\": [\"sfcc-dev-mcp\"]\n }\n }\n}\n```\n\n### Option 2: Full Mode (With SFCC credentials for log and job analysis) \n```json\n{\n \"mcpServers\": {\n \"sfcc-dev\": {\n \"command\": \"npx\",\n \"args\": [\"sfcc-dev-mcp\", \"--dw-json\", \"/path/to/your/dw.json\"]\n }\n }\n}\n```\n\nCreate a `dw.json` file with your SFCC credentials:\n```json\n{\n \"hostname\": \"your-instance.sandbox.us01.dx.commercecloud.salesforce.com\",\n \"username\": \"your-username\",\n \"password\": \"your-password\", \n \"client-id\": \"your-client-id\",\n \"client-secret\": \"your-client-secret\"\n}\n```\n\n## 🎯 Operating Modes\n\n| Mode | Tools Available | SFCC Credentials Required |\n|------|----------------|---------------------------|\n| **Documentation-Only** | 15 tools | ❌ No |\n| **Full Mode** | 36 tools | ✅ Yes |\n\n### Documentation-Only Mode\nPerfect for learning and development - no SFCC instance required:\n- Complete SFCC API documentation (5 tools)\n- Best practices guides (4 tools) – cartridges, client-side JavaScript, controllers, hooks, security/performance \n- SFRA documentation (5 tools)\n- Cartridge generation (1 tool)\n\n### Full Mode \nComplete development experience with live SFCC instance access:\n- All documentation-only features (15 tools)\n- Real-time log analysis (13 tools)\n- System object definitions (6 tools)\n- Code version management (2 tools)\n\n## � Architecture Overview\n\nThis server is built around a **capability-gated, modular handler architecture** that cleanly separates tool routing from domain logic:\n\n### Core Layers\n- **Tool Definitions** (`src/core/tool-definitions.ts`): Declarative schemas grouped by category (documentation, best practices, SFRA, logs, job logs, system objects, cartridge generation, code versions).\n- **Handlers** (`src/core/handlers/*.ts`): Each category has a handler extending a common base for timing, structured logging, and error normalization (e.g. `log-handler`, `docs-handler`, `system-object-handler`).\n- **Clients** (`src/clients/`): Encapsulate domain operations (OCAPI, SFRA docs, best practices, modular log analysis). Handlers delegate to these so orchestration and computation remain separate.\n- **Services** (`src/services/`): Dependency-injected abstractions for filesystem and path operations — improves testability and isolates side effects.\n- **Modular Log System** (`src/clients/logs/`): Reader (range/tail optimization), discovery, processor (line → structured entry), analyzer (patterns & health), formatter (human output) for maintainable evolution.\n- **Configuration Factory** (`src/config/configuration-factory.ts`): Determines capabilities (`canAccessLogs`, `canAccessOCAPI`) based on provided credentials and filters exposed tools accordingly (principle of least privilege).\n\n### Why This Matters\n- **Extensibility**: Adding a new tool usually means adding a schema + minimal handler logic (or a new handler if a new domain).\n- **Security**: Tools that require credentials are never exposed when capability flags are false.\n- **Testability**: Unit tests target clients & modules; integration/MCP tests validate handler routing and response structure.\n- **Performance**: Tail log reads + lightweight caching (`cache.ts`, `log-cache.ts`) reduce unnecessary I/O.\n\n### Adding a New Tool (High-Level)\n1. Add schema object to the correct exported array in `tool-definitions.ts`.\n2. Implement domain logic in a client/service (avoid bloating handlers).\n3. Extend an existing handler or create a new one if it's a new category.\n4. (Only for a new category) register the new handler inside `registerHandlers()` in `server.ts`.\n5. Discover actual response shape with `npx mcp-aegis query` before writing tests.\n6. Add Jest unit tests + YAML MCP tests (docs vs full mode if credentials required).\n7. Update documentation (Development Guide + README counts if changed).\n\n> For a deeper internal view, see the Development Guide in the docs site.\n\n## �🤖 AI Interface Setup\n\nChoose your preferred AI assistant:\n\n| Interface | Best For | Setup Guide |\n|-----------|----------|-------------|\n| **Claude Desktop** | Multi-turn conversations, debugging | [📖 Setup Guide](https://taurgis.github.io/sfcc-dev-mcp/ai-interfaces#claude-desktop) |\n| **GitHub Copilot** | VS Code integration, inline suggestions | [📖 Setup Guide](https://taurgis.github.io/sfcc-dev-mcp/ai-interfaces#github-copilot) |\n| **Cursor** | Modern AI-powered editor | [📖 Setup Guide](https://taurgis.github.io/sfcc-dev-mcp/ai-interfaces#cursor) |\n\n## 📦 Installation\n\n### Using npx (Recommended)\n> Tip: Add `-y` (or `--yes`) to suppress the interactive prompt npx shows before downloading a package. This prevents AI clients (Claude Desktop, Copilot, Cursor) from hanging waiting for confirmation.\n```bash\n# Test the server\nnpx -y sfcc-dev-mcp\n\n# Use with your configuration\nnpx -y sfcc-dev-mcp --dw-json /path/to/your/dw.json\n```\n\n### Global Installation\n```bash\nnpm install -g sfcc-dev-mcp\nsfcc-dev-mcp --dw-json /path/to/your/dw.json\n```\n\n## 🐛 Debug Mode & Logging\n\n### Enable Debug Logging\n```bash\n# Enable debug mode for detailed logging\nnpx -y sfcc-dev-mcp --debug\n\n# Or with configuration file\nnpx -y sfcc-dev-mcp --dw-json /path/to/your/dw.json --debug\n```\n\n### Log File Locations\n\nThe server writes logs to your system's temporary directory:\n\n- **macOS**: `/var/folders/{user-id}/T/sfcc-mcp-logs/`\n- **Linux**: `/tmp/sfcc-mcp-logs/` \n- **Windows**: `%TEMP%\\sfcc-mcp-logs\\`\n\n**Log Files Created:**\n- `sfcc-mcp-info.log` - General application logs and startup messages\n- `sfcc-mcp-debug.log` - Detailed debug information (only when `--debug` is enabled)\n- `sfcc-mcp-error.log` - Error messages and stack traces\n- `sfcc-mcp-warn.log` - Warning messages\n\n### Finding Your Log Directory\n```javascript\n// The exact path varies by system - to find yours:\nnode -e \"console.log(require('os').tmpdir() + '/sfcc-mcp-logs')\"\n\n## 📖 Documentation\n\n**📚 [Complete Documentation](https://taurgis.github.io/sfcc-dev-mcp/)** - Comprehensive guides and references\n\nQuick Links:\n- **[Installation Guide](https://taurgis.github.io/sfcc-dev-mcp/installation)** - Detailed installation options\n- **[AI Interface Setup](https://taurgis.github.io/sfcc-dev-mcp/ai-interfaces)** - Configure Claude Desktop, GitHub Copilot, or Cursor\n- **[Configuration Guide](https://taurgis.github.io/sfcc-dev-mcp/configuration)** - SFCC credentials and Data API setup\n- **[Available Tools](https://taurgis.github.io/sfcc-dev-mcp/tools)** - Complete tool reference\n- **[Examples](https://taurgis.github.io/sfcc-dev-mcp/examples)** - Real-world usage patterns\n- **[Troubleshooting](https://taurgis.github.io/sfcc-dev-mcp/troubleshooting)** - Common issues and solutions\n\n## 🛠️ Example AI Interactions\n\n```\n🧑‍💻 \"Create a new SFCC controller for product search\"\n🤖 Generates complete controller with proper imports, route handling, and SFRA patterns\n\n🧑‍💻 \"What's wrong with my checkout flow? Check the logs\" \n🤖 Analyzes recent error logs, identifies issues, and suggests fixes\n\n🧑‍💻 \"Show me how to implement OCAPI hooks for order validation\"\n🤖 Provides best practices guide with complete hook implementation examples\n```\n\n## 🔒 Security Notes\n\n- **Local Development Focus**: Designed for individual developer use on local machines\n- **Credential Protection**: dw.json files should never be committed to version control\n- **Network Security**: All API calls use HTTPS with proper authentication\n- **No Data Storage**: Server doesn't persist any SFCC data locally\n\n## 🔮 Future Plans\n\nWe're continuously improving the SFCC Development MCP Server with exciting new features planned:\n\n### 🎯 Upcoming Enhancements\n\n- **🧠 Smarter Log Fetching** - Enhanced log analysis with intelligent filtering, pattern recognition, and contextual error correlation\n- **🚀 Deployment Tools** - Integration with SFCC deployment processes and code version management\n\n### 🤝 We Welcome Your Contributions!\n\nHave ideas for new features or improvements? We'd love to hear from you! \n\n- **💡 Feature Requests**: Open an issue to discuss your ideas\n- **🐛 Bug Reports**: Help us improve by reporting any issues you encounter \n- **🔧 Pull Requests**: Contribute code, documentation, or examples\n- **📚 Documentation**: Help expand our guides and best practices\n\nCheck out our [Contributing Guide](CONTRIBUTING.md) to get started, or browse our [open issues](https://github.com/taurgis/sfcc-dev-mcp/issues) to see where you can help.\n\n**Your expertise and feedback make this tool better for the entire SFCC community!**\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n**🚀 Ready to supercharge your SFCC development with AI?**\n\n**[📖 Get Started with the Full Documentation](https://taurgis.github.io/sfcc-dev-mcp/)**\n","English","tag","en-US",{"_41":42,"_13":43,"_52":32,"_53":32,"_16":54,"_55":56,"_33":34,"_68":69,"_76":-5,"_77":78,"_79":80,"_126":127,"_132":-5,"_63":104,"_133":134,"_66":135,"_136":137},"addedAt","2025-08-12T07:02:29.656286Z",[44,45,46,47,48,49,50,51],"category:developer-tools","category:documentation-access","environment:network","hosting:hybrid","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText",10314,"integrations",[57],{"_58":59,"_31":65,"_66":67},"brand",{"_60":61,"_33":62,"_63":64},"logoSvgPath","M10.006 5.415a4.195 4.195 0 013.045-1.306c1.56 0 2.954.9 3.69 2.205.63-.3 1.35-.45 2.1-.45 2.85 0 5.159 2.34 5.159 5.22s-2.31 5.22-5.176 5.22c-.345 0-.69-.044-1.02-.104a3.75 3.75 0 01-3.3 1.95c-.6 0-1.155-.15-1.65-.375A4.314 4.314 0 018.88 20.4a4.302 4.302 0 01-4.05-2.82c-.27.062-.54.076-.825.076-2.204 0-4.005-1.8-4.005-4.05 0-1.5.811-2.805 2.01-3.51-.255-.57-.39-1.2-.39-1.846 0-2.58 2.1-4.65 4.65-4.65 1.53 0 2.85.705 3.72 1.8","Salesforce","slug","salesforce","Provides comprehensive tools for Salesforce B2C Commerce Cloud (SFCC) development including log analysis and monitoring, SFCC API documentation querying, system object definitions access, and best practices guides for OCAPI hooks, SCAPI hooks, SFRA controllers, and custom endpoints","uid","hpw7cb3gj2","namespace",{"_70":71,"_63":75},"owner",{"_72":73},"githubAccount",{"_74":75},"login","taurgis","readmeMarkdown","redditPostExternalId","1mo3d1o","repository",{"_81":82,"_89":90,"_93":94,"_114":-5,"_115":116,"_117":118,"_121":122},"argumentsJsonSchema",{"_83":84,"_85":86,"_87":88},"properties",{},"required",[],"type","object","githubProject",{"_35":36,"_91":92},"url","https://github.com/taurgis/sfcc-dev-mcp","githubRepository",{"_95":96,"_97":98,"_99":100,"_16":101,"_102":103,"_33":104,"_70":105,"_107":108,"_109":110,"_112":113},"defaultBranch","main","fullName","taurgis/sfcc-dev-mcp","githubTreeId",965811,22965,"language","TypeScript","sfcc-dev-mcp",{"_74":75,"_66":106},"hmvr1r7dr8","recentStargazers",1,"spdxLicense",{"_33":111},"MIT License","stargazers",9,"glamaJson","inspectable",true,"npmPackage",{"_33":104,"_119":120},"weeklyDownloads",203,"supportedPlatforms",[123,124,125],"MACOS","WINDOWS","LINUX","scores",{"_128":129,"_130":129,"_131":129},"license",100,"quality","security","simpleIcon","toolCount",12,"van1sdm0ew","updatedAt","2025-10-06T19:05:22.240471Z","meta",[140,143,145,152,155,157,160,163,166,169,172,174,177,180,182,184,186,188,190],{"_141":142},"title","SFCC Development MCP Server | Glama",{"_144":32,"_33":31},"content",{"_146":147,"_148":149,"_150":151},"href","https://glama.ai/mcp/servers/@taurgis/sfcc-dev-mcp","rel","canonical","tagName","link",{"_144":34,"_153":154},"property","og:title",{"_144":32,"_153":156},"og:description",{"_144":158,"_153":159},"https://glama.ai/logo.png","og:logo",{"_144":161,"_153":162},"https://glama.ai/mcp/servers/@taurgis/sfcc-dev-mcp/og-image","og:image",{"_144":164,"_153":165},"630","og:image:height",{"_144":167,"_153":168},"1200","og:image:width",{"_144":170,"_153":171},"website","og:type",{"_144":147,"_153":173},"og:url",{"_144":175,"_153":176},"Glama – MCP Hosting Platform","og:site_name",{"_144":178,"_33":179},"summary_large_image","twitter:card",{"_144":175,"_33":181},"twitter:title",{"_144":32,"_33":183},"twitter:description",{"_144":161,"_33":185},"twitter:image",{"_144":164,"_33":187},"twitter:image:height",{"_144":167,"_33":189},"twitter:image:width",{"_191":192},"script:ld+json",{"_193":194,"_195":196},"@context","http://schema.org","@graph",[197],{"_193":198,"_199":200,"_201":202},"https://schema.org","@type","BreadcrumbList","itemListElement",[203,209,213,217],{"_199":204,"_205":206,"_33":207,"_208":108},"ListItem","item","/","Glama","position",{"_199":204,"_205":210,"_33":211,"_208":212},"/mcp","MCP",2,{"_199":204,"_205":214,"_33":215,"_208":216},"/mcp/servers","Servers",3,{"_199":204,"_205":218,"_33":34,"_208":219},"/mcp/servers/@taurgis/sfcc-dev-mcp",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_224":225,"_29":231,"_250":251,"_138":264,"_262":288,"_289":290},"blob",{"_144":226,"_227":228,"_229":230},"\n","fileName","favicon.svg","size",1048,{"_41":42,"_13":232,"_52":32,"_53":32,"_16":54,"_55":233,"_33":34,"_68":236,"_76":-5,"_77":78,"_79":239,"_126":249,"_132":-5,"_63":104,"_133":134,"_66":135,"_136":137},[44,45,46,47,48,49,50,51],[234],{"_58":235,"_31":65,"_66":67},{"_60":61,"_33":62,"_63":64},{"_70":237,"_63":75},{"_72":238},{"_74":75},{"_81":240,"_89":243,"_93":244,"_114":-5,"_115":116,"_117":247,"_121":248},{"_83":241,"_85":242,"_87":88},{},[],{"_35":36,"_91":92},{"_95":96,"_97":98,"_99":100,"_16":101,"_102":103,"_33":104,"_70":245,"_107":108,"_109":246,"_112":113},{"_74":75,"_66":106},{"_33":111},{"_33":104,"_119":120},[123,124,125],{"_128":129,"_130":129,"_131":129},"member",{"_252":253,"_256":257,"_258":259,"_99":260,"_261":221,"_262":228,"_263":116,"_229":230,"_87":224},"commit",{"_254":255},"sha","0cdc9f803c3eab607020dd523cb5084ec554123a","contentStoredObjectPointerId",10715295,"fullPath","docs-site/public/favicon.svg",257032,"indexable","path","safeToDisplayAsText",[265,267,269,271,273,274,275,277,278,279,280,281,282,283,284,285,286,287],{"_141":266},"favicon.svg | SFCC Development MCP Server | Glama",{"_144":268,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_146":270,"_148":149,"_150":151},"https://glama.ai/mcp/servers/@taurgis/sfcc-dev-mcp/blob/0cdc9f803c3eab607020dd523cb5084ec554123a/docs-site/public",{"_144":272,"_153":154},"favicon.svg | SFCC Development MCP Server",{"_144":268,"_153":156},{"_144":158,"_153":159},{"_144":276,"_153":162},"https://glama.ai/generated-images/og?title=favicon.svg+%7C+SFCC+Development+MCP+Server",{"_144":164,"_153":165},{"_144":167,"_153":168},{"_144":170,"_153":171},{"_144":270,"_153":173},{"_144":175,"_153":176},{"_144":178,"_33":179},{"_144":175,"_33":181},{"_144":268,"_33":183},{"_144":276,"_33":185},{"_144":164,"_33":187},{"_144":167,"_33":189},"docs-site/public","treeMembers",[291,295,299,303,307,311,315,319,323,327,329,333,337],{"_252":292,"_258":293,"_262":294,"_87":224},{"_254":255},"docs-site/public/404.html","404.html",{"_252":296,"_258":297,"_262":298,"_87":224},{"_254":255},"docs-site/public/android-chrome-192x192.png","android-chrome-192x192.png",{"_252":300,"_258":301,"_262":302,"_87":224},{"_254":255},"docs-site/public/android-chrome-512x512.png","android-chrome-512x512.png",{"_252":304,"_258":305,"_262":306,"_87":224},{"_254":255},"docs-site/public/apple-touch-icon.png","apple-touch-icon.png",{"_252":308,"_258":309,"_262":310,"_87":224},{"_254":255},"docs-site/public/explain-product-pricing-methods-no-mcp.png","explain-product-pricing-methods-no-mcp.png",{"_252":312,"_258":313,"_262":314,"_87":224},{"_254":255},"docs-site/public/explain-product-pricing-methods.png","explain-product-pricing-methods.png",{"_252":316,"_258":317,"_262":318,"_87":224},{"_254":255},"docs-site/public/favicon-16x16.png","favicon-16x16.png",{"_252":320,"_258":321,"_262":322,"_87":224},{"_254":255},"docs-site/public/favicon-32x32.png","favicon-32x32.png",{"_252":324,"_258":325,"_262":326,"_87":224},{"_254":255},"docs-site/public/favicon.ico","favicon.ico",{"_252":328,"_258":259,"_262":228,"_87":224},{"_254":255},{"_252":330,"_258":331,"_262":332,"_87":224},{"_254":255},"docs-site/public/llms.txt","llms.txt",{"_252":334,"_258":335,"_262":336,"_87":224},{"_254":255},"docs-site/public/robots.txt","robots.txt",{"_252":338,"_258":339,"_262":340,"_87":224},{"_254":255},"docs-site/public/sitemap.xml","sitemap.xml","actionData","errors"]

MCP directory API