SnowLens v2.0

Understand incidents. Decide faster. · Sandy Android Works

Note: SnowLens is for ServiceNow (IT Service Management platform), NOT Snowflake (data warehouse). "Snow" refers to ServiceNow, and "Lens" means intelligent visibility.

SnowLens is an AI-powered SRE co-pilot that transforms ServiceNow into an intelligent system. It connects to your ServiceNow instance, understands incidents (not just displays them), summarizes critical information, detects patterns across historical data, and recommends actionable next steps to reduce MTTR (Mean Time To Resolution).

What is ServiceNow?

ServiceNow is an IT service management (ITSM) platform used by organizations to manage incidents, problems, changes, and IT operations. SnowLens makes ServiceNow smarter by adding AI-powered analysis and recommendations.

🎯 What Does SnowLens Do?

Understand & Summarize - Auto-summarize incidents and surface the most relevant worknotes
Detect Patterns - Automatically correlate historical incidents and surface repeating patterns
Recommend Actions - Provide prioritized, actionable next steps and runbook guidance

📋 Prerequisites

Before you start, make sure you have these installed on your computer:

Required Software

Python 3.8 or higher - Download Python
Node.js 16 or higher - Download Node.js
npm (comes with Node.js)
ServiceNow Instance Access - You need credentials for a ServiceNow instance (ask your IT admin or use a developer instance from ServiceNow Developer Program)

Check if you have them installed:

python --version    # Should show Python 3.8+
node --version      # Should show v16+
npm --version       # Should show 8+

🚀 Installation & Setup

Step 1: Clone or Download the Project

# If using git
git clone <repository-url>
cd servicenow-mcp

# Or just navigate to your project folder
cd /path/to/servicenow-mcp

Step 2: Install Python Dependencies

# Install all Python packages needed for the backend
pip install fastapi uvicorn anthropic requests python-dotenv

What these packages do:

fastapi - Web framework for building the API
uvicorn - Server to run the FastAPI application
anthropic - Claude AI integration
requests - Make HTTP requests to ServiceNow
python-dotenv - Load environment variables

Step 3: Install UI Dependencies

# Navigate to the UI folder
cd ui

# Install all Node.js packages
npm install

# Go back to the main folder
cd ..

Step 4: Configure Environment Variables

Create a file named .env in the main project folder:

# Create .env file
touch .env

Add these lines to your .env file:

# ServiceNow Configuration
SERVICENOW_INSTANCE=your-instance-name
SERVICENOW_USERNAME=your-username
SERVICENOW_PASSWORD=your-password

# Anthropic API Key (for Claude AI)
ANTHROPIC_API_KEY=your-anthropic-api-key

# Optional: Server Configuration
API_PORT=6001
UI_PORT=5173

Where to get these:

ServiceNow credentials: Ask your ServiceNow admin
Anthropic API Key: Get from Anthropic Console

🎬 How to Start Everything

Option 1: Start Everything Manually (Recommended for Learning)

Terminal 1 - Start the Backend API Server

# Make sure you're in the main project folder
cd /path/to/servicenow-mcp

# Start the FastAPI backend server
python sre_agent_api.py

What you should see:

INFO:     Started server process [12345]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:6001 (Press CTRL+C to quit)

The backend is now running on: http://localhost:6001

Terminal 2 - Start the UI Development Server

Open a new terminal window (keep the first one running!):

# Navigate to the UI folder
cd /path/to/servicenow-mcp/ui

# Start the React development server
npm run dev

What you should see:

  VITE v5.x.x  ready in 500 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: use --host to expose
  ➜  press h + enter to show help

The UI is now running on: http://localhost:5173

Option 2: Start Everything in Background

If you want to run everything in the background:

# Start backend in background
nohup python sre_agent_api.py > backend.log 2>&1 &

# Start UI in background
cd ui
nohup npm run dev > ui.log 2>&1 &
cd ..

To check logs:

# View backend logs
tail -f backend.log

# View UI logs
tail -f ui/ui.log

To stop background processes:

# Find process IDs
ps aux | grep "sre_agent_api.py"
ps aux | grep "vite"

# Kill processes (replace PID with actual process ID)
kill <PID>

🌐 Access the Application

Open your web browser
Go to: http://localhost:5173
You'll see the SnowLens landing page

First Time Login

Demo Credentials:

Username: demo
PIN: 1234

Or create a new account by clicking "Get Started"

📁 Project Structure

servicenow-mcp/
├── sre_agent_api.py          # Main FastAPI backend server
├── sre_agent.py              # Core SRE agent logic
├── servicenow_server.py      # ServiceNow MCP integration
├── test_client.py            # Testing utilities
├── test_snow.py              # ServiceNow connection tests
├── conversations.json        # Stored conversation history
├── users.json                # User accounts and PINs
├── .env                      # Environment variables (create this!)
├── README.md                 # This file
└── ui/                       # React frontend
    ├── package.json          # UI dependencies
    ├── vite.config.js        # Vite configuration
    ├── index.html            # HTML entry point
    └── src/
        ├── main.jsx          # React entry point
        ├── App.jsx           # Main React component
        └── index.css         # Tailwind CSS styles

🔧 Troubleshooting

Problem: "Port already in use"

Solution:

# Find what's using port 6001
lsof -i :6001

# Kill the process (replace PID with actual number)
kill -9 <PID>

# Or use a different port by editing sre_agent_api.py
# Change: uvicorn.run(app, host="0.0.0.0", port=6001)
# To:     uvicorn.run(app, host="0.0.0.0", port=6002)

Problem: "Module not found" error

Solution:

# Reinstall Python dependencies
pip install --upgrade fastapi uvicorn anthropic requests python-dotenv

# Reinstall UI dependencies
cd ui
rm -rf node_modules package-lock.json
npm install
cd ..

Problem: UI won't connect to backend

Solution:

Make sure backend is running on port 6001
Check ui/src/App.jsx - API_BASE_URL should be http://localhost:6001
Check browser console (F12) for CORS errors

Problem: "Invalid credentials" when testing ServiceNow

Solution:

Verify your .env file has correct credentials
Test ServiceNow connection:

python test_snow.py

Problem: Can't see any incidents

Solution:

Make sure ServiceNow credentials are correct
Check that your ServiceNow instance is accessible
Verify you have permission to read incidents in ServiceNow

🧪 Testing the Setup

Test 1: Check Backend API

# In your browser or using curl
curl http://localhost:6001/health

# Should return: {"status":"healthy"}

Test 2: Check ServiceNow Connection

python test_snow.py

Test 3: Test Full Flow

Open http://localhost:5173
Login with demo/1234
Type a question like "Show me recent incidents"
Should see incidents from ServiceNow

🛑 How to Stop Everything

If running in foreground:

Press CTRL + C in each terminal window

If running in background:

# Find and kill backend
pkill -f "sre_agent_api.py"

# Find and kill UI server
pkill -f "vite"

# Or find process IDs and kill manually
ps aux | grep "python"
ps aux | grep "node"
kill <PID>

📝 Development Tips

Making Changes to the UI

Edit files in ui/src/
Changes automatically reload in browser (hot reload)
No need to restart the server

Making Changes to the Backend

Edit sre_agent_api.py or related files
Must restart the backend server (CTRL+C then run again)

Viewing Logs

# Backend logs (if running with nohup)
tail -f backend.log

# UI logs (if running with nohup)
tail -f ui/ui.log

# Or just watch the terminal where you started them

🚀 Features

✅ Current Features

🔐 User authentication with PIN
💬 Conversational AI interface powered by Claude
📊 ServiceNow incident summarization
🔍 Pattern detection across historical ServiceNow incidents
📝 ServiceNow worknote analysis
💡 Resolution recommendations based on similar incidents
📜 Conversation history persistence
🎯 Full analysis mode for deep incident investigation
🔗 Real-time ServiceNow integration via MCP

🚀 Tech Stack

Backend: FastAPI, Python 3.8+, Anthropic Claude AI
Frontend: React 18, Vite, Tailwind CSS
Integration: ServiceNow via Model Context Protocol (MCP)
Platform: ServiceNow (ITSM), NOT Snowflake

📞 Support

Having issues? Here's what to check:

✅ Python and Node.js installed?
✅ All dependencies installed?
✅ .env file configured?
✅ Both servers running?
✅ Correct ports (6001 for API, 5173 for UI)?
✅ ServiceNow credentials valid?

📄 License

🙏 Credits

Built with ❤️ using:

SnowLens v2.0 - Turn ServiceNow into an intelligent system 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 9 Commits
.venv		.venv
__pycache__		__pycache__
ui		ui
README.md		README.md
conversations.json		conversations.json
servicenow_server.py		servicenow_server.py
sre_agent.py		sre_agent.py
sre_agent_api.py		sre_agent_api.py
test_client.py		test_client.py
test_snow.py		test_snow.py
users.json		users.json

Folders and files

Latest commit

History

Repository files navigation

SnowLens v2.0

What is ServiceNow?

🎯 What Does SnowLens Do?

📋 Prerequisites

Required Software

Check if you have them installed:

🚀 Installation & Setup

Step 1: Clone or Download the Project

Step 2: Install Python Dependencies

Step 3: Install UI Dependencies

Step 4: Configure Environment Variables

🎬 How to Start Everything

Option 1: Start Everything Manually (Recommended for Learning)

Terminal 1 - Start the Backend API Server

Terminal 2 - Start the UI Development Server

Option 2: Start Everything in Background

🌐 Access the Application

First Time Login

📁 Project Structure

🔧 Troubleshooting

Problem: "Port already in use"

Problem: "Module not found" error

Problem: UI won't connect to backend

Problem: "Invalid credentials" when testing ServiceNow

Problem: Can't see any incidents

🧪 Testing the Setup

Test 1: Check Backend API

Test 2: Check ServiceNow Connection

Test 3: Test Full Flow

🛑 How to Stop Everything

If running in foreground:

If running in background:

📝 Development Tips

Making Changes to the UI

Making Changes to the Backend

Viewing Logs

🚀 Features

✅ Current Features

🚀 Tech Stack

📞 Support

📄 License

🙏 Credits

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages