Service Catalog Creator App 🚀

📋 Overview

The Service Catalog Creator App revolutionizes ServiceNow service catalog management by leveraging AI to transform simple natural language descriptions into fully-configured catalog items. This intelligent tool bridges the gap between business requirements and technical implementation.

🎯 What It Does

• 🧠 AI-Powered Generation: Convert natural language prompts into structured service catalog entries
• 🔍 Smart Duplicate Detection: Automatically checks for existing records before creation
• 🔗 ServiceNow Integration: Direct, seamless integration with your ServiceNow instance
• 📡 MCP Server Support: Built-in Model Context Protocol integration for enhanced AI capabilities
• 📄 JSON Export: Generate standardized, ServiceNow-compatible JSON files
• ⚡ Batch Processing: Handle multiple catalog entries efficiently

✨ Key Features

🛠️ Technology Stack

Technology	Purpose	Version
	Core Language	3.10+
	HTTP Client	0.28.1+
	Protocol Server	1.12.2+
	Target Platform	Latest
	Data Format	Standard

🚀 Quick Start Guide

📋 Prerequisites

⚡ Installation

# Clone the repository (requires permission)
git clone <repository-url>
cd service-cat-creator-app

# Install dependencies
pip install -e .

# Verify installation
python -c "import service_cat_creator; print('✅ Installation successful!')"

🔧 Environment Setup

Create a .env file in the project root:

# ServiceNow Configuration
SERVICENOW_INSTANCE=your-instance.service-now.com
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password

# Optional: Advanced Settings
SERVICENOW_API_VERSION=v1
TIMEOUT_SECONDS=30
MAX_RETRIES=3

🎯 Basic Usage

from service_cat_creator import ServiceCatalogCreator

# Initialize the creator
creator = ServiceCatalogCreator()

# Create from natural language
prompt = """
Create a laptop request service for employees that includes:
- Choice of laptop type (Standard, Premium, Developer)
- Memory options (8GB, 16GB, 32GB)
- Storage options (256GB SSD, 512GB SSD, 1TB SSD)
- Justification field for business need
"""

# Generate and create in ServiceNow
result = creator.create_from_prompt(prompt)
print(f"✅ Created service: {result['name']}")

🔧 MCP Server Integration

This application provides comprehensive MCP (Model Context Protocol) server integration for enhanced AI capabilities.

📡 MCP Client Configuration

{
  "mcpServers": {
    "service-catalog-creator": {
      "command": "python",
      "args": ["-m", "service_cat_creator.mcp_server"],
      "env": {
        "SERVICENOW_INSTANCE": "your-instance.service-now.com",
        "SERVICENOW_USERNAME": "${SERVICENOW_USERNAME}",
        "SERVICENOW_PASSWORD": "${SERVICENOW_PASSWORD}"
      }
    }
  }
}

🛠️ Available MCP Tools

📊 JSON Format & Schema

🏗️ ServiceNow-Compatible Structure

{
  "name": "Laptop Request",
  "short_description": "Request a new laptop for work",
  "description": "Submit a request for a new laptop with specific requirements",
  "category": "Hardware",
  "subcategory": "Computer Equipment",
  "state": "Published",
  "active": true,
  "variables": [
    {
      "name": "laptop_type",
      "question": "Select laptop type",
      "type": "choice",
      "choices": ["Standard", "Premium", "Developer"],
      "mandatory": true,
      "order": 1
    },
    {
      "name": "memory_size",
      "question": "Select memory configuration",
      "type": "choice",
      "choices": ["8GB", "16GB", "32GB"],
      "mandatory": true,
      "order": 2
    }
  ],
  "variables_set": "Hardware Request Variables",
  "app_scope": "global",
  "owner": "admin",
  "workflow": "Hardware Approval Process"
}

📋 Schema Validation

The application automatically validates generated JSON against ServiceNow schema requirements:

• ✅ Required field validation
• ✅ Data type checking
• ✅ Choice list validation
• ✅ Workflow compatibility
• ✅ Permission verification

🎯 Use Cases & Examples

# Hardware requests
creator.create_from_prompt("Create a desktop computer request with OS options")

# Software requests  
creator.create_from_prompt("Create software license request for Adobe Creative Suite")

# Access requests
creator.create_from_prompt("Create VPN access request with approval workflow")

# Onboarding
creator.create_from_prompt("Create new employee onboarding checklist service")

# Benefits
creator.create_from_prompt("Create health insurance enrollment service")

# Time off
creator.create_from_prompt("Create vacation request service with manager approval")

# Space requests
creator.create_from_prompt("Create conference room booking service")

# Maintenance
creator.create_from_prompt("Create facility maintenance request service")

# Security
creator.create_from_prompt("Create building access card request service")

📖 Advanced API Reference

🔧 ServiceCatalogCreator Class

🤝 Contributing & Development

🔒 Access Requirements

To contribute or access the source code:

1. Request Permission: Contact shah.divya.2206@gmail.com
2. Provide Justification: Explain your intended use case
3. Agree to Terms: Accept additional licensing terms
4. Wait for Approval: Receive written authorization

🛠️ Development Setup

# After receiving permission
git clone <repository-url>
cd service-cat-creator-app

# Install development dependencies
pip install -e ".[dev]"