Device42 MCP Server (Node.js)

MCP server for Device42 IT asset management - Node.js/TypeScript implementation.

Features

• Fast: Uses native fetch (Node 18+), no heavy HTTP libs
• Type-safe: Full TypeScript
• Minimal deps: Only @modelcontextprotocol/sdk and zod
• Read/Write modes: Set D42_READONLY=false to enable write operations

Installation

npm install
npm run build

Usage

With Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "device42": {
      "command": "node",
      "args": ["/path/to/device42-mcp/dist/index.js"],
      "env": {
        "D42_URL": "https://your-device42.com",
        "D42_USERNAME": "api-user",
        "D42_PASSWORD": "api-password",
        "D42_VERIFY_SSL": "true",
        "D42_READONLY": "true"
      }
    }
  }
}

With Docker

docker build -t device42-mcp:latest .

docker run -i --rm \
  -e D42_URL="https://your-device42.com" \
  -e D42_USERNAME="user" \
  -e D42_PASSWORD="pass" \
  device42-mcp:latest

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | D42_URL | Yes | - | Device42 instance URL | | D42_USERNAME | Yes | - | API username | | D42_PASSWORD | Yes | - | API password | | D42_VERIFY_SSL | No | true | Verify SSL certificates | | D42_READONLY | No | true | Only expose read operations |

Available Tools

Read Operations

• list_devices, get_device, get_device_by_name, search_devices
• list_ips, get_ip, search_ips_by_device
• list_subnets, get_subnet
• list_racks, get_rack
• list_rooms, get_room
• list_buildings, get_building
• list_vlans, get_vlan
• list_software, get_software
• list_business_apps, get_business_app
• list_app_components, get_app_component
• list_hardware_models, list_operating_systems, list_vendors
• doql_query - Execute raw DOQL queries

Write Operations (when D42_READONLY=false)

• create_device, update_device
• assign_ip_to_device, release_ip
• create_subnet, create_rack, create_room, create_building

Development

# Run in dev mode (tsx)
npm run dev

# Type check
npm run typecheck

# Build
npm run build