asic-rs-mcp

MCP server for Bitcoin ASIC miner management. Wraps asic-rs to expose miner discovery, data gathering, and control as MCP tools.

Install

cargo install --path .

Usage

asic-rs-mcp                              # uses ./asic-rs-mcp.toml if present
asic-rs-mcp --config /etc/asic-rs.toml   # explicit config path
ASIC_RS_MCP_CONFIG=~/.config/asic-rs-mcp.toml asic-rs-mcp

The server communicates over stdio (stdin/stdout). Tracing logs go to stderr. Set RUST_LOG=debug for verbose output.

Claude Desktop

{
  "mcpServers": {
    "asic-rs": {
      "command": "asic-rs-mcp",
      "args": ["--config", "/path/to/asic-rs-mcp.toml"]
    }
  }
}

Configuration

Copy and edit asic-rs-mcp.toml:

[server]
data_timeout_secs = 30          # per-miner data calls
control_timeout_secs = 60       # control operations (restart, set_pools, etc.)
identification_timeout_secs = 10 # miner identification during discovery
scan_timeout_secs = 300         # total scan_network timeout
fleet_timeout_secs = 120        # total get_fleet_data timeout
fleet_concurrency_limit = 50    # max concurrent connections in fleet ops

[credentials.default]
username = "root"
password = "root"

# Per-firmware overrides
[credentials.antminer]
username = "root"
password = "root"

[credentials.whatsminer]
username = "admin"
password = "admin"

[credentials.vnish]
password = "admin"

[credentials.epic]
password = "letmein"

# Per-IP overrides (highest priority)
[credentials.miners."192.168.1.50"]
username = "custom_user"
password = "custom_pass"

Credential resolution order: per-IP > per-firmware > default.

Note: asic-rs v0.2.x hardcodes credentials in each backend and does not expose a credential injection API. The config is forward-compatible infrastructure -- credentials will be wired automatically once upstream adds support.

Tools (29)

Discovery

| Tool | Description | |-|-| | scan_network | Scan a subnet/range for miners. Supports make/firmware filters, configurable timeouts and concurrency. | | get_miner | Connect to a single miner by IP. Returns device info and supported capabilities. | | listen_for_miners | Passive UDP discovery (AntMiner port 14235, WhatsMiner port 8888). |

Data Gathering

| Tool | Description | |-|-| | get_miner_data | All data in one call (30 fields). | | get_fleet_data | Concurrent get_miner_data across multiple IPs. | | get_hashrate | Current hashrate with unit and algorithm. | | get_expected_hashrate | Expected/nominal hashrate. | | get_wattage | Current power consumption (watts). | | get_wattage_limit | Configured power limit. | | get_hashboards | Per-board temps, hashrate, chip details. | | get_fans | Fan speeds. | | get_psu_fans | PSU fan speeds. | | get_fluid_temperature | Coolant temperature (immersion setups). | | get_hostname | Network hostname. | | get_mac | MAC address. | | get_serial_number | Serial number. | | get_api_version | Miner API version. | | get_firmware_version | Firmware version string. | | get_uptime | System uptime. | | get_is_mining | Whether the miner is actively hashing. | | get_light_flashing | Fault light status. | | get_messages | Miner log messages with severity. | | get_pools | Current pool configuration. |

Control

Each control tool checks supports_* before executing and returns { "supported": false } if the miner doesn't support the operation.

| Tool | Description | |-|-| | restart_miner | Restart the miner. | | set_fault_light | Turn locate/fault LED on or off. | | pause_mining | Pause mining (optional delay). | | resume_mining | Resume mining (optional delay). | | set_pools | Replace pool configuration (destructive). | | set_wattage_limit | Set power limit in watts. |

Typical Workflow

scan_network("192.168.1.0/24")  ->  list of IPs
get_fleet_data([ips])           ->  health data for all miners
get_hashboards("192.168.1.10")  ->  drill into a specific miner
set_fault_light("192.168.1.10", true)  ->  locate it physically

Supported Hardware

All miners supported by asic-rs: AntMiner, WhatsMiner, AvalonMiner, Bitaxe, NerdAxe, and firmware variants BraiinsOS, VNish, LuxOS, EPic, Marathon, HiveOS.

License

MIT