EasyShell MCP Server

Model Context Protocol server for EasyShell: manage hosts, execute scripts, orchestrate multi-host tasks, schedule AI inspections, and access infrastructure operations from AI assistants.

Features

• 19 tools across 3 tiers
• Tier 1 Core (6): list_hosts, get_host_detail, execute_script, get_task_detail, list_scripts, ai_chat
• Tier 2 Management (8): list_recent_tasks, create_script, list_clusters, get_dashboard_stats, get_host_metrics, list_scheduled_tasks, trigger_inspection, get_inspect_reports
• Tier 3 Advanced (5): manage_tags, query_audit_logs, approve_task, send_notification, search_knowledge

Quick Start

Claude Desktop

Add to your MCP configuration:

{
  "mcpServers": {
    "easyshell": {
      "command": "npx",
      "args": ["-y", "@easyshell/mcp-server"],
      "env": {
        "EASYSHELL_URL": "http://localhost:18080",
        "EASYSHELL_USER": "easyshell",
        "EASYSHELL_PASS": "easyshell@changeme"
      }
    }
  }
}

Cursor

Use the same MCP server block in your Cursor MCP settings.

OpenCode

Use the same MCP server block in your OpenCode MCP configuration.

Configuration

| Variable | Required | Description | |---|---:|---| | EASYSHELL_URL | Yes | EasyShell server API endpoint (for example http://localhost:18080). | | EASYSHELL_USER | Yes | EasyShell username. | | EASYSHELL_PASS | Yes | EasyShell password. |

Transport Modes

stdio (default)

Used by Claude Desktop, Cursor, OpenCode, and other local AI clients:

npx -y @easyshell/mcp-server

HTTP (SSE + Streamable HTTP)

For remote deployments, Smithery.ai, or browser-based clients:

npx -y @easyshell/mcp-server --port 3000

Bind to all interfaces for remote access:

npx -y @easyshell/mcp-server --port 3000 --host 0.0.0.0

Endpoints:

| Endpoint | Method | Protocol | |---|---|---| | /mcp | POST / GET / DELETE | Streamable HTTP (2025-03-26) | | /sse | GET | Legacy SSE (2024-11-05) | | /messages?sessionId=<id> | POST | Legacy SSE message handler | | /health | GET | Health check |

Full Tool Reference

| Tier | Tool | Purpose | |---|---|---| | Core | list_hosts | List hosts and filter by status. | | Core | get_host_detail | Fetch detailed host information. | | Core | execute_script | Execute script content on selected hosts. | | Core | get_task_detail | Retrieve detailed task execution results. | | Core | list_scripts | List scripts from script library. | | Core | ai_chat | Run natural-language AI operations orchestration. | | Management | list_recent_tasks | Query recent execution tasks. | | Management | create_script | Create and save reusable scripts. | | Management | list_clusters | List host clusters/groups. | | Management | get_dashboard_stats | Get platform KPI and overview stats. | | Management | get_host_metrics | Get host metrics history. | | Management | list_scheduled_tasks | List configured scheduled inspections. | | Management | trigger_inspection | Trigger an inspection immediately. | | Management | get_inspect_reports | Read AI inspection analysis reports. | | Advanced | manage_tags | Manage host tags and assignments. | | Advanced | query_audit_logs | Search audit and compliance logs. | | Advanced | approve_task | Approve or reject high-risk operations. | | Advanced | send_notification | Send notifications to configured channels. | | Advanced | search_knowledge | Search operational knowledge base. |

Auto-Install

npx @easyshell/mcp-server --install

Development

npm ci
npm run build
npm run test
npm run inspector

Links

• Documentation: https://docs.easyshell.ai
• Discord: https://discord.gg/WqFD9VQe
• GitHub: https://github.com/easyshell-ai/easyshell