Easyshell

Name: Easyshell
Author: easyshell-ai

@easyshell-ai

About Easyshell

Lightweight server management & intelligent ops platform with Docker one-click deployment, batch script execution, web terminal, and AI-powered operations.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "easyshell-mcp": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Easyshell?

Easyshell is a Model Context Protocol (MCP) server that connects AI assistants to the EasyShell platform for managing hosts, executing scripts, orchestrating multi‑host tasks, scheduling AI inspections, and accessing infrastructure operations. It provides 19 tools across three tiers (Core, Management, Advanced) and is intended for DevOps and infrastructure teams.

How to use Easyshell?

Configure the server by setting three environment variables (EASYSHELL_URL, EASYSHELL_USER, EASYSHELL_PASS) in your MCP client’s configuration (Claude Desktop, Cursor, OpenCode). The server runs locally via npx -y @easyshell/mcp-server (stdio transport) or over HTTP/SSE by using the --port flag.

Key features of Easyshell

19 tools across three tiers (Core, Management, Advanced)
Execute scripts, manage hosts, and orchestrate multi‑host tasks
Schedule and trigger AI inspections with report retrieval
Query audit logs, manage tags, approve high‑risk tasks
Supports stdio (local) and HTTP/SSE (remote) transports

Use cases of Easyshell

Run natural‑language infrastructure operations via ai_chat
Execute scripts on selected hosts and retrieve detailed results
Create and save reusable scripts in the script library
Trigger AI inspections and read analysis reports
Search operational knowledge and audit logs for compliance

FAQ from Easyshell

What environment variables are required to configure the server?

Three environment variables are required: EASYSHELL_URL (the EasyShell API endpoint), EASYSHELL_USER (username), and EASYSHELL_PASS (password).

What transport modes does the server support?

The server supports stdio (default, for local AI clients) and HTTP (SSE + Streamable HTTP) for remote deployments or browser‑based clients.

How do I install and run the Easyshell MCP server?

Install via npm (e.g., npx -y @easyshell/mcp-server). For auto‑install, run npx @easyshell/mcp-server --install. For HTTP mode, add --port (and optionally --host for remote access).

What tools does the server provide?

It offers 19 tools: Core (6) like list_hosts, execute_script, ai_chat; Management (8) like create_script, trigger_inspection, get_inspect_reports; and Advanced (5) like manage_tags, query_audit_logs, approve_task.

Can the server be used in a remote or cloud environment?

Yes. By running with --port 3000 (and optionally --host 0.0.0.0), the server exposes HTTP endpoints for remote access and is compatible with Smithery.ai and browser‑based clients.