ultron-user-mcp-server

UltronSysController/ultron-user-mcp-server

3.2

If you are the rightful owner of ultron-user-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

UltronCloud MCP Server is an enterprise-grade IoT platform API designed for developers and AI agents, offering seamless integration with modern AI assistants and traditional applications.

UltronCloud MCP Server

Version

šŸ  Enterprise-Grade IoT Platform API for Developers & AI Agents

Works with: Claude Desktop • Claude CLI • ChatGPT • LangChain • REST API

Quick Start • Documentation • Examples • Support


🌟 Why UltronCloud Personal Edition?

Build powerful IoT applications in minutes, not months. UltronCloud Personal Edition provides enterprise-grade smart home APIs that work seamlessly with modern AI assistants and traditional applications.

✨ Key Features

  • šŸ” 34 Secure APIs - Production-ready, thoroughly tested endpoints
  • šŸ¤– AI-Native Design - Built for ChatGPT, Claude, LangChain integration
  • ⚔ Real-time Control - Instant device management and status updates
  • šŸ“Š Advanced Analytics - Energy monitoring, sensor data, historical insights
  • šŸŽ­ Scene Management - Create and execute complex automation scenarios
  • šŸ”” Smart Alerts - Intelligent notifications and anomaly detection
  • 🌐 Multi-Protocol - REST API, MCP Server, OpenAPI 3.0 specification
  • šŸš€ Developer-Friendly - Comprehensive docs, examples, and SDKs

šŸš€ Quick Start

Prerequisites

Installation & Setup

# 1. Clone the repository
git clone https://github.com/UltronSysController/ultron-user-mcp-server.git
cd ultron-user-mcp-server

# 2. Install dependencies
npm install

# 3. For Claude CLI/Code users - Global installation
npm link  # Creates global command 'ultron-mcp'

# 4. Run interactive setup (Recommended)
npm run setup
# This will:
# - Ask for your App ID and API Key
# - Fetch your available groups
# - Help you select the right group
# - Test the connection
# - Save everything to .env

# 4. Test your setup
npm test

# 5. Start using
npm start  # Run MCP server

Manual Setup (Alternative)

# If you prefer manual configuration
cp .env.example .env
# Edit .env with:
# - ULTRON_APP_ID=your-app-id
# - ULTRON_API_KEY=your-api-key  
# - ULTRON_GROUP_ID=your-group-id (optional)

šŸ’» Usage Examples

JavaScript/Node.js

import axios from 'axios';

// Configure API client
const ultronAPI = axios.create({
  baseURL: 'https://api.ultroncloud.com',
  headers: {
    'Authorization': `Bearer ${process.env.ULTRON_API_KEY}`,
    'X-App-Id': process.env.ULTRON_APP_ID
  }
});

// Get all devices
const devices = await ultronAPI.post('/usr/v4/GetGroupDevices', {
  groupId: 'grp_123456'
});

// Control a device
const result = await ultronAPI.post('/usr/v4/SendCommand', {
  sn: 'UT3702A0002201234',
  iotDevs: ['Switch'],
  cmd: 'toggle'
});

Python

import requests

headers = {
    'Authorization': f'Bearer {API_KEY}',
    'X-App-Id': APP_ID
}

# Control device
response = requests.post(
    'https://api.ultroncloud.com/usr/v4/SendCommand',
    headers=headers,
    json={'sn': 'device_id', 'iotDevs': ['Switch'], 'cmd': 'on'}
)

šŸ¤– AI Agent Integration

Claude Desktop & CLI

# For Claude Desktop & CLI - Full local control
npm start

# Works with both:
# - Claude Desktop app (macOS/Windows)
# - Claude CLI for terminal/automation
# See CLAUDE_CLI_GUIDE.md for detailed setup

ChatGPT GPTs

  1. Open GPT Builder
  2. Import ultroncloud-api-personal.yaml
  3. Configure authentication with Bearer token and X-App-Id header

Claude Configuration

// Add to claude_desktop_config.json or .claude/config.json
{
  "mcpServers": {
    "ultroncloud": {
      "command": "node",
      "args": ["path/to/ultron-mcp-server.js"],
      "env": {
        "ULTRON_APP_ID": "your-app-id",
        "ULTRON_API_KEY": "your-api-key"
      }
    }
  }
}

LangChain

from langchain.tools import Tool
from langchain.utilities import Requests

requests = Requests(headers={
    'Authorization': f'Bearer {API_KEY}',
    'X-App-Id': APP_ID
})

šŸ“Š API Overview

Available API Categories

CategoryAPIsDescription
Group Management10Groups, members, permissions
Device Management7Device control, status, configuration
Data Analytics5Energy monitoring, sensor data, exports
User Profile5Profile, settings, preferences
Scene Control5Create, edit, apply and delete automation scenes
Firmware Updates1Check device firmware
Automation Query1Get automation rules

šŸ“¦ Project Structure

ultroncloud-api-personal/
ā”œā”€ā”€ ultroncloud-api-personal.yaml  # OpenAPI 3.0 specification
ā”œā”€ā”€ ultron-mcp-server.js          # MCP server for Claude
ā”œā”€ā”€ package.json                  # Node.js package config
ā”œā”€ā”€ .env.example                  # Environment template
ā”œā”€ā”€ DEVELOPER_GUIDE.md            # Complete developer guide
ā”œā”€ā”€ README.md                     # This file
└── examples/                     # Code examples
    ā”œā”€ā”€ javascript/               # JS/Node.js examples
    ā”œā”€ā”€ python/                   # Python examples
    └── postman/                  # Postman collection

šŸŽ† Common Use Cases

Smart Home Dashboard

// Get all devices with real-time status
const dashboard = await Promise.all([
  ultronAPI.post('/usr/v4/GetGroupDevices', { groupId }),
  ultronAPI.post('/usr/v4/GetGroupDeviceStates', { groupId })
]);

Energy Management

// Monitor power consumption
const powerData = await ultronAPI.post('/usr/v4/GetDeviceRealTimeKWh', {
  sn: 'device_serial'
});

Automation Rules

// Create temperature-based automation
const rule = await ultronAPI.post('/usr/v4/CreateSensorRangePolicy', {
  groupId, name: 'Auto AC',
  sensorType: 'temperature',
  range: { min: 20, max: 28 },
  actions: [{ type: 'device_control', config: {...} }]
});

šŸ”’ Security & Best Practices

Security Features

  • āœ… All high-risk operations removed
  • āœ… Role-based access control
  • āœ… Rate limiting protection
  • āœ… Secure authentication with App ID + API Key

Best Practices

  1. Never expose credentials in client-side code
  2. Use environment variables for sensitive data
  3. Implement server-side proxy for web applications
  4. Rotate API keys regularly
  5. Monitor API usage in developer dashboard

šŸ“š Documentation

  • - Complete integration guide
  • - Claude Desktop & CLI setup
  • - OpenAPI specification
  • - Get started in 5 minutes
  • - Code samples in multiple languages

šŸŽÆ Roadmap

  • TypeScript SDK
  • Python SDK
  • Webhook support
  • WebSocket real-time updates
  • GraphQL API
  • More AI platform integrations

šŸ¤ Contributing

We welcome contributions! Please see our for details.

šŸ“§ Support

šŸ“„ License

MIT License - see file for details.

🌟 Acknowledgments

Built with ā¤ļø by the UltronCloud team for the global developer community.


Ready to build the future of IoT?

Get Started Now →