Skip to content
This repository was archived by the owner on May 23, 2026. It is now read-only.

mono-labs-archive/monarch-connect

Repository files navigation

Monarch Connect

Cross-platform desktop application for managing blockchain validator nodes remotely via SSH. Part of the Monarch tooling ecosystem.

Features

  • Multi-server management — Monitor and control multiple validator nodes from a single dashboard
  • SSH-based — Connects to servers using standard SSH keys, no new ports or agents required
  • Real-time monitoring — Live process status, CPU/memory usage, block height, sync progress
  • 7-tab server view — Dashboard, Health, Logs, Setup, Node, Validator, Help
  • Health audits — Run comprehensive doctor checks across 11 categories
  • Claude integration — Built-in MCP server for AI-assisted node management via Claude Desktop/Code
  • Cross-platform — macOS, Linux, and Windows

Architecture

┌─ Monarch Connect (Desktop App) ──────────┐
│  React 19 + TypeScript + Tauri 2 (Rust)  │
│  SSH via russh (pure Rust, async)         │
└──────────────┬────────────────────────────┘
               │ SSH (no new ports)
               ▼
┌─ Remote Server ──────────────────────────┐
│  OxidePM daemon + Monarch CLI            │
│  Cosmos SDK node (monod, gaiad, etc.)    │
└──────────────────────────────────────────┘

Every GUI action maps to an oxidepm or monarch CLI command executed over SSH with --json output. The app has exactly the same permissions as a terminal SSH session.

Getting Started

Prerequisites

Development

pnpm install           # Install frontend dependencies
pnpm build:mcp         # Build MCP server
pnpm tauri dev         # Run in development mode

Build

pnpm tauri build       # Build production binary

MCP Server (Claude Integration)

Monarch Connect includes a built-in MCP server that provides Claude Desktop and Claude Code with:

  • 9 tools — Node status, cosmos status, logs, health checks, RPC queries, start/stop/restart
  • 9 resources — Server profiles, live status, documentation (commands, roles, networks, backup, troubleshooting)
  • Domain knowledge — Validator lifecycle, key management, double-signing prevention, safety rules

Enable it from Settings > Claude Integration in the app. Requires Node.js >= 18 on the client machine.

Server-Side Setup

Your remote servers need the Monarch toolchain installed:

# Install Monarch CLI
curl -fsSL https://raw.githubusercontent.com/monolythium/monarch-cli/prod/scripts/install.sh | bash

# Install OxidePM (process manager)
monarch install-oxidepm

Or let Monarch Connect install them for you — it detects missing tools and shows an install button.

SSH access: Create a dedicated user (e.g., monouser) with SSH key access. Password auth is supported but SSH keys are recommended.

Security

  • SSH key authentication recommended (password auth available as fallback)
  • Supports passphrase-protected SSH keys
  • Only stores paths to SSH keys, never the keys themselves
  • MCP server uses stdio transport (no network ports exposed)
  • Read-only and read-write modes for MCP tools
  • Command inputs are sanitized before shell execution
  • All RPC queries are whitelisted to read-only endpoints

Tech Stack

Layer Technology
Framework Tauri 2
Frontend React 19, TypeScript 5, Vite 6
Styling Tailwind CSS 4, Radix UI
State Zustand 5, TanStack Query/Router
SSH russh (pure Rust, async)
MCP @modelcontextprotocol/sdk

License

Proprietary. Copyright Mono Labs.

About

Cross-platform desktop app for managing blockchain validator nodes remotely via SSH

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors