flinntech/drm-mcp

Digi Remote Manager MCP Server

Model Context Protocol (MCP) server for Digi Remote Manager API integration. Provides 62 tools for managing IoT devices, data streams, alerts, automations, and more.

Features

• Multi-Tenant Support: Single or multi-user mode with per-user credentials and isolated state
• Dynamic Tool Loading: Reduces initial context by ~70% - only loads tools you need
• 62 API Tools: Full coverage of Digi Remote Manager REST API (13 core + 49 on-demand)
• SCI/RCI Support: Direct device communication via Server Command Interface
• Device Management: Query devices, groups, firmware, configurations
• Data Streams: Access time-series telemetry data with rollups
• Monitoring: Alerts, monitors, automations, and reports
• Multiple Transports: Supports stdio and HTTP transports

Dynamic Tool System

The server uses a category-based dynamic tool loading system to reduce LLM context usage:

Core Tools (Always Available - 13 tools)

• Tool Management: list_tool_categories, load_tool_category
• Device Basics: list_devices, get_device
• Stream Basics: list_streams, get_stream, get_stream_history
• Organization: list_groups, get_group
• Monitoring: list_alerts, get_alert
• Account: get_account_info, get_api_info

On-Demand Categories (49 tools organized into 11 categories)

Load additional tools by category using load_tool_category:

• bulk_operations (5 tools) - CSV export for devices, streams, jobs, events
• advanced_data (3 tools) - Stream rollups, aggregations, device logs
• automations (6 tools) - Workflow automation management
• firmware (4 tools) - Firmware management and updates
• sci (9 tools) - Direct device communication via SCI/RCI
• monitors (3 tools) - Webhook and monitor management
• jobs (2 tools) - Async job tracking
• user_management (3 tools) - User accounts, security settings
• configuration (4 tools) - Device templates, health monitoring configs
• files (2 tools) - File listing and retrieval
• events (2 tools) - Audit trail and event history

Usage Pattern

1. Connect to server - only 13 core tools visible
2. Call list_tool_categories to see available categories
3. Call load_tool_category with category name (e.g., "configuration")
4. All tools in that category become available
5. Repeat as needed for other categories

Prerequisites

• Node.js 18.0.0 or higher
• Digi Remote Manager account
• API Key ID and Secret (get from https://remotemanager.digi.com → Profile → API Keys)

Quick Start

1. Clone and Install

git clone <repository-url>
cd DRM_MCP
npm install

2. Build the TypeScript Code

The server is written in TypeScript. Build it before running:

npm run build

This compiles the TypeScript code in src/ to JavaScript in dist/.

3. Configure Environment

Copy the example environment file and configure your API credentials:

cp .env.example .env

Edit .env and add your API credentials:

DRM_API_KEY_ID=your_api_key_id_here
DRM_API_KEY_SECRET=your_api_key_secret_here

4. Run the Server

Stdio mode (default) - for MCP clients like Claude Desktop:

npm start

HTTP mode - for web integrations like n8n:

MCP_TRANSPORT=http MCP_PORT=3000 npm start

Development

The project is written in TypeScript with full type safety.

Project Structure

drm-mcp/
├── src/
│   ├── types/
│   │   ├── auth.types.ts      # Authentication & multi-tenant types
│   │   ├── tool.types.ts      # Tool system types
│   │   ├── api.types.ts       # DRM API response types
│   │   └── server.types.ts    # Server configuration types
│   └── server.ts              # Main server implementation
├── dist/                      # Compiled JavaScript (generated)
├── tsconfig.json              # TypeScript configuration
└── package.json

Development Workflow

Watch mode - automatically recompile on changes:

npm run dev

Build for production:

npm run build

Type check without building:

npx tsc --noEmit

TypeScript Benefits

• Type safety for all 60+ tool arguments and responses
• Compile-time validation of API calls and data structures
• Better IDE support with autocomplete and inline documentation
• Refactoring safety across the 2,700+ line codebase
• Multi-tenant credential type checking

Multi-Tenant Configuration

The server supports two modes:

Single-Tenant Mode (Default)

Use environment variables for a single set of credentials:

DRM_API_KEY_ID=your_api_key_id_here
DRM_API_KEY_SECRET=your_api_key_secret_here

All requests will use these credentials.

Multi-Tenant Mode

For multiple users with different DRM credentials:

1. Create credentials.json in the project root:

{
  "user1": {
    "api_key_id": "user1_key_id",
    "api_key_secret": "user1_key_secret"
  },
  "user2": {
    "api_key_id": "user2_key_id",
    "api_key_secret": "user2_key_secret"
  },
  "alice": {
    "api_key_id": "alice_key_id",
    "api_key_secret": "alice_key_secret"
  }
}

2. When making HTTP requests to the MCP server, include the X-User-ID header:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "X-User-ID: alice" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

3. Each user's credentials will be used for their requests
4. Tool categories are tracked separately per user

Security Notes:

• credentials.json is gitignored by default
• Store credentials securely
• Each user gets isolated access with their own DRM API credentials
• Per-user tool category state is maintained in memory

Docker Deployment

Using Docker Compose

1. Configure environment variables in .env:

cp .env.example .env
# Edit .env with your credentials

2. Start the server:

docker-compose up -d

3. Check logs:

docker-compose logs -f

4. Health check:

curl http://localhost:3000/health

Manual Docker Build

docker build -t drm-mcp-server .
docker run -d \
  -e DRM_API_KEY_ID=your_key_id \
  -e DRM_API_KEY_SECRET=your_key_secret \
  -e MCP_TRANSPORT=http \
  -e MCP_PORT=3000 \
  -p 3000:3000 \
  drm-mcp-server

Environment Variables

Usage Examples

List Available Tool Categories

{
  "tool": "list_tool_categories",
  "arguments": {}
}

Load a Tool Category

{
  "tool": "load_tool_category",
  "arguments": {
    "category": "configuration"
  }
}

List Connected Devices

{
  "tool": "list_devices",
  "arguments": {
    "query": "connection_status=\"connected\"",
    "size": 100
  }
}

Get Stream Historical Data

{
  "tool": "get_stream_history",
  "arguments": {
    "stream_id": "00000000-00000000-00409DFF-FF122B8E/temperature",
    "start_time": "-24h",
    "size": 1000
  }
}

Query Device State via SCI

{
  "tool": "sci_query_device_state",
  "arguments": {
    "device_id": "00000000-00000000-00409DFF-FF122B8E",
    "state_group": "mobile_stats",
    "use_cache": false
  }
}

Available Tools

Device Management

• list_devices, get_device
• list_groups, get_group
• list_firmware, get_firmware

Data & Telemetry

• list_streams, get_stream, get_stream_history
• get_stream_rollups (aggregated data)
• get_device_logs

Monitoring & Automation

• list_alerts, get_alert
• list_monitors, get_monitor
• list_automations, get_automation

SCI/RCI (Direct Device Communication)

• sci_query_device_state
• sci_query_device_settings
• sci_list_device_files, sci_get_device_file
• sci_query_multiple_devices

Reports & Analytics

• get_connection_report
• get_device_report
• get_cellular_utilization_report

See tool descriptions for complete parameter documentation.

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run with custom environment
DRM_API_KEY_ID=xxx DRM_API_KEY_SECRET=yyy npm start

Troubleshooting

Error: API credentials not configured

Make sure you've set both environment variables:

• DRM_API_KEY_ID
• DRM_API_KEY_SECRET

Check that your .env file exists and contains valid credentials.

401 Authentication Error

Verify your API credentials are correct in Digi Remote Manager.

403 Permission Denied

Some features require Remote Manager Premier Edition.

License

MIT