Xtranumerik-inc/xibo-mcp-lite

🚀 Xibo MCP Lite - Claude Desktop Optimized

Professional MCP Server for Xibo Digital Signage CMS - Claude Desktop Compatible Edition

✨ Features

• 🎯 Claude Desktop Optimized - Stable MCP transport with lazy loading
• 🛠️ 101 Xibo Tools - Complete API coverage with smart filtering
• 🔐 Dual Authentication - OAuth2 Client Credentials + Direct User Auth
• ⚡ Lazy Loading - Tools load on-demand for better performance
• 🔒 Permission Filtering - Dynamic tool filtering based on user level
• 🎨 Professional UI - Clean, responsive interface for all tools

🚀 Quick Start

1. Clone and Install

git clone https://github.com/Xtranumerik-inc/xibo-mcp-lite.git
cd xibo-mcp-lite
npm install

2. Configure Environment

# Copy example configuration
cp .env.example .env

# Edit .env with your Xibo CMS details
nano .env

3. Build and Test

# Build TypeScript
npm run build

# Test connection
npm test

4. Configure Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "xibo-mcp-lite": {
      "command": "node",
      "args": ["path/to/xibo-mcp-lite/dist/index.js"]
    }
  }
}

📋 Configuration

Option 1: OAuth2 Client Credentials (Recommended)

XIBO_AUTH_MODE=client_credentials
XIBO_API_URL=https://your-xibo-cms.com
XIBO_CLIENT_ID=your_client_id
XIBO_CLIENT_SECRET=your_client_secret
COMPANY_NAME=Your Company

Option 2: Direct User Authentication

XIBO_AUTH_MODE=direct_user
XIBO_API_URL=https://your-xibo-cms.com
XIBO_USERNAME=your_username
XIBO_PASSWORD=your_password
COMPANY_NAME=Your Company

🛠️ Available Tools (101 Total)

Core Tools (32)

• Displays (7 tools) - Screen management and monitoring
• Layouts (4 tools) - Layout creation and modification
• Media (5 tools) - Asset management and upload
• Campaigns (4 tools) - Campaign management
• Playlists (3 tools) - Playlist operations
• Schedules (4 tools) - Content scheduling
• Display Groups (2 tools) - Group management
• Broadcasting (3 tools) - Intelligent geo-targeted broadcasting

Advanced Tools (61)

• Users & Permissions (2 tools) - User management
• Folders & Security (1 tool) - Content organization
• Statistics & Analytics (1 tool) - Basic reporting
• Datasets & Sync (2 tools) - Dynamic data management
• Templates & Widgets (10 tools) - Advanced design tools
• Notifications & Alerts (2 tools) - Emergency broadcasting
• System Configuration (9 tools) - CMS management
• Transitions & Effects (7 tools) - Visual enhancements
• Multi-CMS Sync (6 tools) - Cross-platform sync
• Menu Boards (5 tools) - Restaurant menu management
• Automation & Workflows (5 tools) - Process automation

Professional Tools (8)

• System Administration (5 tools) - Complete system control
• Analytics & Reports (6 tools) - Advanced reporting
• OAuth2 & Security (8 tools) - Security management

🔧 Claude Desktop Optimizations

• Lazy Loading - Tools load only when first requested
• Enhanced Error Handling - Graceful failure recovery
• Simplified Logging - No console override conflicts
• Memory Optimization - Reduced memory footprint
• Connection Stability - Improved MCP transport reliability

🚨 Troubleshooting

Server Won't Start

# Check environment variables
node -e "console.log(require('dotenv').config())"

# Test authentication
npm run test-auth

Claude Desktop Connection Issues

1. Restart Claude Desktop completely
2. Check logs at: %APPDATA%/Claude/logs/mcp-server-xibo-mcp-lite.log
3. Verify file paths are absolute in configuration

Permission Issues

• Tools are filtered based on your Xibo user permissions
• Super Admin sees all 101 tools
• Regular users see filtered subsets

📞 Support

• 📧 Email: support@xtranumerik.ca
• 🌐 Website: https://www.xtranumerik.ca
• 📚 Documentation: See /docs folder
• 🐛 Issues: GitHub Issues

📄 License

MIT License - see file for details.

Developed by Xtranumerik Inc. 🇨🇦 - Professional Digital Signage Solutions