agentnodex

v0.5.0

Published

2 months ago

AI-native infrastructure management platform with 31 MCP tools, 11 specialized agents, enterprise authentication, and natural language operations through Claude Desktop

0High
0Medium
0Low

scaledminds

agent ai autonomous framework nodejs typescript

AgentNodeX

AI-Native Infrastructure Management - Talk to Your Servers

v0.5.0 - Now with MCP Server: Manage Infrastructure Through Natural Language

🚀 What's New in v0.5.0

AI-Native Operations - AgentNodeX is the first infrastructure platform you can operate entirely through natural language conversations with AI assistants like Claude Desktop.

You: "What's the system load and are there any issues?"
Claude: [Uses AgentNodeX] "Load: 0.45, Memory: 4.2GB/16GB.
        No issues detected. nginx and postgresql running normally."

You: "Deploy my Node.js app from github.com/myuser/myapp"
Claude: [Uses AgentNodeX] "Deployment successful!
        Your app is live at myapp.com with SSL."

27 Operational Tools via Model Context Protocol (MCP):

System discovery & monitoring
Application deployment & management
Log analysis & troubleshooting
Security scanning & hardening
Self-healing & diagnostics

No CLI commands to remember. Just describe what you want.

The Problem

Infrastructure management is complex, time-consuming, and error-prone:

Complex: Remember dozens of commands, config files, and procedures
Time-Consuming: Manual deployments, monitoring, security updates
Error-Prone: One typo can break everything
Siloed: Separate tools for monitoring, logs, deployment, security
Reactive: You only know about problems when things break

The Solution

AgentNodeX is an AI-native infrastructure management platform that lets you manage your entire infrastructure through natural language conversations with AI assistants like Claude Desktop.

v0.5.0: MCP Server with 27 Operational Tools

Instead of memorizing commands, you simply describe what you want:

You: "What's running on this server and are there any security issues?"
Claude: [Using AgentNodeX MCP Server]
        "Running: nginx, postgresql-16, redis-7, nodejs-app-1, nodejs-app-2
         Security: No critical issues. 3 available system updates.
         Last security scan: 2 hours ago, status: PASS"

You: "Apply those updates and show me the deployment status"
Claude: [Using AgentNodeX MCP Server]
        "Updates applied successfully. All services restarted.
         Deployments: nodejs-app-1 (v2.3.1, healthy), nodejs-app-2 (v1.4.0, healthy)"

What Makes It Transformative

Natural Language Operations

No CLI commands to remember - just describe what you want
27 operational tools accessible through conversation
Role-based access control (6 security roles)
Approval workflows for HIGH/CRITICAL operations
Works with Claude Desktop, Zed, and any MCP-compatible AI assistant

Comprehensive Operations Coverage

System Discovery: Hardware, network, services, security posture
Monitoring: Real-time metrics, alerts, health checks, resource usage
Log Management: Search, analyze, identify error patterns
Deployments: Create, monitor, rollback, scale applications
Security: Scans, hardening, firewall, credential rotation
Self-Healing: Diagnose issues, restart services, repair configs

Enterprise Security Built-In

JWT authentication with session management
Role-based access control (RBAC) with wildcard permissions
Approval workflows for destructive operations
Fail-secure authentication (cannot bypass in production)
Comprehensive audit logging
47 security tests with 100% pass rate

Future Vision: Full Autonomous Platform

v1.0: Complete hosting platform (static, PHP, containers)
v1.1: Multi-node clustering and advanced monitoring
v2.0: Multi-tenancy, marketplace, and enterprise features
Built on proven agent architecture (12 specialized AI agents)

Quick Start

Option 1: Use with Claude Desktop (Recommended - 10 minutes)

Talk to your infrastructure through AI:

# 1. Install AgentNodeX
npm install -g agentnodex

# 2. Initialize configuration
agentnodex init
export AGENTNODEX_ADMIN_PASSWORD="YourSecurePassword123!"

# 3. Start MCP Server
agentnodex mcp:server

4. Configure Claude Desktop:

Add to ~/.config/Claude/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "agentnodex": {
      "command": "agentnodex",
      "args": ["mcp:server"],
      "env": {
        "AGENTNODEX_ADMIN_PASSWORD": "YourSecurePassword123!"
      }
    }
  }
}

5. Restart Claude Desktop and start talking:

You: "What's the system status?"
You: "Deploy my app from github.com/myuser/myapp"
You: "Show me recent error logs"
You: "Run a security scan"

Complete guides:

Quick Start Guide - 10-minute setup
MCP User Guide - Complete reference
Tools Reference - All 27 tools

Option 2: CLI Usage (Coming in v1.0)

# Full CLI with autonomous deployment coming in v1.0
agentnodex deploy --git https://github.com/user/app --domain app.com
agentnodex system status
agentnodex logs myapp

Architecture

v0.5.0: MCP Server with Tool-Agent Integration

Current State (v0.5.0):

AI Assistant (Claude Desktop, Zed, etc.)
           ↓
    MCP Protocol (stdio)
           ↓
    AgentNodeX MCP Server
    - Authentication & Authorization
    - 27 Operational Tools
    - Permission Enforcement
    - Approval Workflows
           ↓
    Tool-Agent Integration
    - Scout Tools (5) → SCOUT Agent
    - Observer Tools (5) → OBSERVER Agent
    - Scribe Tools (4) → SCRIBE Agent
    - Deploy Tools (6) → DEPLOY Agent
    - Sentinel Tools (4) → SENTINEL Agent
    - Medic Tools (3) → MEDIC Agent
           ↓
    System Operations

Key Components (v0.5.0):

MCP Server Layer

Model Context Protocol server (stdio transport)
JWT authentication with role-based access control
6 security roles: super_admin, admin, operator, developer, readonly, guest
Approval workflows for HIGH/CRITICAL operations
Comprehensive input validation and error handling

Operational Tools (27 tools across 6 categories)

Scout Tools: System discovery, hardware info, network config, security scanning
Observer Tools: Metrics, alerts, health checks, resource monitoring
Scribe Tools: Log search, analysis, error pattern detection
Deploy Tools: Application deployment, monitoring, rollback, scaling
Sentinel Tools: Security hardening, firewall management, credential rotation
Medic Tools: Self-healing diagnostics, service restart, config repair

Agent Foundation (12 specialized agents)

Proven architecture with event-based communication
Task orchestration and state management
Error handling and recovery
Full agent coordination coming in v1.0

Future: Full Agent Orchestration (v1.0+)

When you deploy an app in v1.0, NEXUS will orchestrate 5+ agents running concurrently:

SCOUT verifies DNS + SENTINEL checks firewall (parallel)
DEPLOY clones repo and builds Docker image
SENTINEL provisions SSL certificate
ROUTER configures Traefik routing
OBSERVER + SCRIBE start monitoring (parallel)

All coordinated with quality gates and automatic rollback if anything fails.

See: System Architecture for complete technical details

Features

✅ Available Now (v0.5.0)

Natural Language Operations

Talk to your infrastructure through AI assistants
No commands to memorize - just describe what you want
27 operational tools via Model Context Protocol
Works with Claude Desktop, Zed, and MCP-compatible AI tools

System Discovery & Monitoring

Real-time system information (OS, kernel, uptime, users)
Hardware specifications (CPU, memory, disk, network)
Service discovery and monitoring
Network configuration and connectivity
Security posture assessment

Log Management & Analysis

Search logs with powerful filtering (time, severity, service)
Analyze error patterns and trends
View recent logs from any service
Log statistics and metrics
Security event detection

Application Deployment

Create and manage deployments
Monitor deployment status and health
View deployment logs in real-time
Rollback to previous versions
Scale deployments up/down

Security Operations

Comprehensive security scanning
System hardening recommendations
Firewall rule management
Credential rotation
Security compliance checking

Self-Healing & Diagnostics

Automatic issue diagnosis
Service health checking and restart
Configuration validation and repair
Resource usage monitoring
Alert management

Enterprise Security

JWT authentication with session management
Role-based access control (6 roles)
Approval workflows for HIGH/CRITICAL operations
Fail-secure authentication
Comprehensive audit logging
47 security tests (100% passing)

🔜 Coming in v1.0 (Q1 2026)

Full Autonomous Hosting Platform

One-command deployments from Git to live in under 2 minutes
Zero-downtime blue-green deployments with automatic rollback
Multi-tier hosting (static sites, PHP apps, containerized apps)
Automatic SSL certificate provisioning (Let's Encrypt)
Database management (PostgreSQL, MySQL, MongoDB, Redis)
Git webhook integration for auto-deploy
Multi-environment support (dev, staging, production)

Advanced Monitoring

Prometheus + Grafana dashboards
Centralized logging (Loki + Fluent Bit)
Performance metrics and visualization
Configurable alert routing

Backup & Recovery

Automated backup scheduling
Database dumps and volume snapshots
Encrypted backups with GPG
One-command disaster recovery

🚀 Coming in v1.1+ (Q2-Q4 2026)

Multi-Node Clustering (v1.1)

Coordinate multiple nodes
Load balancing and failover
Distributed deployments

Enterprise Features (v2.0)

Multi-tenancy support
SSO and advanced RBAC
Marketplace and plugin system
Web dashboard

Use Cases

For Individual Developers

Host all your side projects on one $5 VPS
No more paying $20/month per app on managed platforms
Perfect for portfolios, demos, and personal projects

For Startups

Enterprise-grade infrastructure without enterprise costs
Scale from prototype to production on the same platform
Focus on product, not infrastructure

For Agencies

Host dozens of client sites on managed nodes
Perfect isolation prevents client cross-contamination
Automated backups and monitoring for every client

For Teams

Self-hosted alternative to Heroku/Netlify/Vercel
Complete control and privacy
No vendor lock-in

For Education

Students can learn production-grade DevOps
Safe experimentation with self-healing
Real-world infrastructure skills

Why AgentNodeX?

vs Manual Server Management

100x faster setup (10 min vs weeks)
Zero manual SSL management
Automatic security hardening
Self-healing instead of pager duty

vs Coolify/CapRover

AI-powered instead of manual configuration
Perfect application isolation (they share resources)
Self-healing with automated rollback
Multi-tier architecture support

vs Managed Platforms (Heroku/Vercel)

80-95% cost savings
No vendor lock-in
Complete control
Better performance (dedicated resources)

vs Kubernetes

10x simpler for small-to-medium deployments
No ops team required
Autonomous management
Perfect for 1-100 applications

Compatibility

Supported Linux Distributions

Ubuntu 20.04+
Debian 11+
CentOS 8+
Rocky Linux 8+
AlmaLinux 8+
RHEL 8+
Arch Linux
Alpine Linux 3.15+

Supported Application Types

Static Sites: HTML, CSS, JavaScript, React, Vue, Angular
PHP: WordPress, Laravel, Symfony, custom PHP apps
Node.js: Express, Next.js, Nest.js, etc.
Python: Django, Flask, FastAPI, etc.
Ruby: Rails, Sinatra, etc.
Go: Any Go application
Java: Spring Boot, etc.
Databases: PostgreSQL, MySQL, MongoDB, Redis
Anything Docker can run

Documentation

Getting Started

Quick Start Guide - Get up and running in 10 minutes
MCP User Guide - Complete guide to using AgentNodeX with Claude Desktop
MCP Tools Reference - All 27 tools with examples

Architecture & Development

System Architecture - Complete system design
Agent Specifications - Detailed agent protocols
Security Review - v0.5.0 security analysis
Security Fixes - All CRITICAL issues resolved

Project Planning

Roadmap - Development roadmap and timeline
Contributing Guide - How to contribute

Installation

Prerequisites

Linux server (VPS or bare metal)
Node.js 18+ installed
1GB+ RAM (2GB+ recommended)
10GB+ disk space
Root or sudo access

Install AgentNodeX

# From NPM (recommended)
npm install -g agentnodex

# Or from source
git clone https://github.com/ScaledMinds/AgentNodeX.git
cd AgentNodeX
npm install
npm run build
npm link

Initialize Configuration

# Create default configuration
agentnodex init

# Set admin password (REQUIRED for MCP server)
export AGENTNODEX_ADMIN_PASSWORD="YourSecurePassword123!"

Start MCP Server

# Start the MCP server (keep this terminal open)
agentnodex mcp:server

Configure Claude Desktop

macOS: Edit ~/Library/Application Support/Claude/claude_desktop_config.json Linux: Edit ~/.config/Claude/claude_desktop_config.json Windows: Edit %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "agentnodex": {
      "command": "agentnodex",
      "args": ["mcp:server"],
      "env": {
        "AGENTNODEX_ADMIN_PASSWORD": "YourSecurePassword123!"
      }
    }
  }
}

Restart Claude Desktop and you're ready!

Complete setup guide: docs/guides/QUICK-START.md

Usage Examples

Natural Language Operations (v0.5.0)

System Discovery:

You: "What's the system information?"
You: "Show me the hardware specs"
You: "What services are running?"
You: "What's the network configuration?"

Monitoring:

You: "What's the current system load and memory usage?"
You: "Are there any alerts?"
You: "Check if nginx is healthy"
You: "Show me resource usage for the last 5 minutes"

Log Analysis:

You: "Show me recent nginx error logs"
You: "Search for errors in the last hour"
You: "What are the top error patterns?"
You: "Analyze authentication failures"

Deployment Management:

You: "Deploy my Node.js app from github.com/myuser/myapp"
You: "What's the status of my-app deployment?"
You: "Show me deployment logs"
You: "Rollback my-app to the previous version"
You: "Scale my-app to 3 replicas"

Security Operations:

You: "Run a security scan"
You: "Apply security hardening (requires approval)"
You: "Check firewall rules"
You: "Rotate credentials for my-app (requires approval)"

Troubleshooting:

You: "My nginx service isn't working, can you diagnose the problem?"
You: "Restart the postgresql service (requires approval)"
You: "Check the configuration for my-app"

CLI Commands (Coming in v1.0)

# Full CLI with autonomous deployment coming in v1.0
agentnodex deploy --git https://github.com/user/app --domain app.com
agentnodex system status
agentnodex logs myapp
agentnodex rollback myapp

Configuration

Current (v0.5.0): Configuration is managed through environment variables and the agentnodex init command.

Coming in v1.0: Applications will support a .agentnodex.yml file for declarative configuration:

version: 1
tier: container

deployment:
  strategy: blue-green
  health_check:
    path: /health
    timeout: 30s
    interval: 10s

build:
  dockerfile: Dockerfile
  context: .
  args:
    NODE_ENV: production

environment:
  - NODE_ENV=production
  - PORT=3000

resources:
  cpu: 1.0
  memory: 1024M

database:
  type: postgresql
  version: 16
  resources:
    memory: 512M

volumes:
  - ./data:/app/data:rw

Contributing

We welcome contributions! AgentNodeX is designed to be the most transformative open-source hosting platform.

See CONTRIBUTING.md for guidelines.

Development Setup

git clone https://github.com/ScaledMinds/AgentNodeX.git
cd AgentNodeX
npm install
npm run dev
npm test

Community

GitHub Discussions: Feature requests and Q&A
GitHub Issues: Bug reports and tracking
Discord: Coming soon
Twitter: @AgentNodeX

Roadmap

See ROADMAP.md for detailed development plans.

v0.5.0 (Current - January 2025) - MCP Server Launch ✅

27 operational tools via Model Context Protocol
Natural language infrastructure management
JWT authentication with RBAC (6 security roles)
Approval workflows for HIGH/CRITICAL operations
Tool-agent integration (Scout, Observer, Scribe, Deploy, Sentinel, Medic)
Comprehensive security fixes (3 CRITICAL issues resolved)
47 security tests passing
Complete user documentation

v0.6.0 (February 2025) - Enhanced Operations

Additional tools based on user feedback
Performance optimizations
Enhanced logging and diagnostics
Web dashboard (alpha)

v1.0.0 (Q1 2026) - Full Autonomous Platform

Complete hosting platform (static, PHP, containers)
One-command Git-to-live deployments
Blue-green deployments with automatic rollback
Automatic SSL certificate management
Database management (PostgreSQL, MySQL, MongoDB, Redis)
Prometheus + Grafana monitoring
Full agent orchestration (NEXUS coordination)
Multi-distro support
CIS compliance automation

v1.1.0 (Q2 2026) - Scale & Intelligence

Multi-node clustering
Load balancing and failover
ML-powered anomaly detection
Predictive scaling
Advanced monitoring and alerting

v2.0.0 (Q4 2026) - Enterprise Ready

Multi-tenancy support
SSO and advanced RBAC
Marketplace and plugin ecosystem
White-label support
Enterprise SLA guarantees

License

MIT License - see LICENSE file for details.

Credits

Built with:

Claude Code - AI-powered agents
Docker - Containerization
Traefik - Reverse proxy
Prometheus - Monitoring
Grafana - Visualization
Loki - Log aggregation

Support

Documentation: docs.agentnodex.dev
Issues: GitHub Issues
Commercial Support: [email protected]

AgentNodeX: Because infrastructure should be autonomous, not a full-time job.

Transform your $5 VPS into a $500 managed platform. Deploy with confidence. Sleep soundly.