EasyShell MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "EASYSHELL_API_KEY=${EASYSHELL_API_KEY}" easyshell -- npx -y @easyshell-ai/easyshell
Required:EASYSHELL_API_KEY
README.md

AI-Native Server Operations Platform

EasyShell

AI-Native Server Operations Platform

Let AI write your scripts, orchestrate multi-host tasks, and analyze your infrastructure — while you focus on what matters.

Language: English | 简体中文 | 繁體中文 | 한국어 | Русский | 日本語


Why EasyShell?

Traditional server management tools expect you to write every script, SSH into every box, and interpret every output yourself. EasyShell flips that model: AI is the operator, you are the decision-maker.

  • Describe what you need in plain language → AI writes production-ready shell scripts with diff review
  • Set a goal across multiple hosts → AI plans the execution steps, runs them, and synthesizes the results
  • Schedule automated inspections → AI analyzes output and decides whether to alert your team via bot channels
  • Connect via Web SSH → Full terminal with file manager, multi-tab, search — no local client needed

Core Features

1. AI Script Assistant

Describe what you want. AI writes the script. Review the diff. One click to apply.

The AI Script Workbench is a split-panel editor where you describe requirements in natural language, and AI generates (or modifies) shell scripts targeting your chosen OS. Real-time streaming shows the script being written. A built-in diff view highlights exactly what changed. A summary tab explains the modifications in your language.

How it works:

  1. Describe — write your requirements in natural language, choose the target OS
  2. Generate — AI streams a production-ready script in real time
  3. Review — built-in diff view highlights every change; summary tab explains modifications
  4. Apply — one click to save the script to your library or dispatch it immediately

2. AI Task Orchestration

"Check disk and memory on all hosts, flag anything over 80%, and suggest fixes." — Done.

The AI Chat interface lets you issue high-level operational goals. AI decomposes them into a multi-step execution plan (explore → analyze → report), dispatches scripts to target hosts, collects results, and delivers a structured analysis with risk assessment and actionable recommendations — all in a single conversation turn.

How it works:

  1. Instruct — describe a high-level goal in the AI Chat (e.g. "check disk on all hosts")
  2. Plan — AI decomposes the goal into a multi-step execution plan (explore → analyze → report)
  3. Execute — scripts are dispatched to target hosts in parallel; results collected automatically
  4. Report — AI delivers a structured analysis with risk assessment and actionable recommendations

3. AI Scheduled Inspections

Cron → Script → AI Analysis → Intelligent Alert — AI analyzes output and decides whether to alert your team.

Schedule inspection tasks with cron expressions and select scripts from the built-in script library. EasyShell dispatches them to agents on schedule, collects output (disk, memory, services, logs), sends it to your AI model for intelligent analysis, and lets AI decide whether the results warrant an alert — pushing notifications only when they matter.

How it works:

  1. Configure — cron expression + script (from library or custom) + AI analysis prompt + notification rules
  2. Execute — EasyShell dispatches to target agents on schedule
  3. Analyze — Output sent to AI model (OpenAI / Gemini / GitHub Copilot / Custom) for intelligent analysis
  4. Notify — AI determines severity and pushes alerts via bot channels when action is needed

Notification modes: Always push, push on failure, push on warning, or AI decides — the AI model evaluates the output and autonomously determines if an alert is necessary.

Supported Bot Channels (Configuration Guide):

Bot Status
Telegram ✅ Supported
Discord ✅ Sup

Tools (3)

execute_scriptExecute a shell script on a target host or group of hosts.
orchestrate_taskDecompose a high-level operational goal into a multi-step execution plan across multiple hosts.
schedule_inspectionConfigure a recurring inspection task with cron expressions and AI-powered output analysis.

Environment Variables

EASYSHELL_API_KEYrequiredAPI key for authenticating with the EasyShell platform.

Configuration

claude_desktop_config.json
{ "mcpServers": { "easyshell": { "command": "npx", "args": ["-y", "@easyshell-ai/easyshell"] } } }

Try it

Check disk and memory usage on all production hosts and flag anything over 80%.
Write a shell script to update all Nginx configurations on my web servers and show me the diff.
Schedule a daily inspection of system logs on the database cluster and alert me if any critical errors are found.
Orchestrate a task to restart the application service across all nodes in the staging environment.

Frequently Asked Questions

What are the key features of EasyShell?

AI-generated shell scripts with built-in diff review. Multi-host task orchestration and execution planning. Cron-based automated infrastructure inspections. Intelligent AI-powered analysis of command output. Automated alerting based on AI-determined severity.

What can I use EasyShell for?

Automating routine server health checks across a distributed infrastructure.. Generating and applying configuration changes to multiple servers simultaneously.. Intelligently monitoring system logs and only receiving alerts for actionable issues.. Standardizing server maintenance tasks through AI-assisted script generation..

How do I install EasyShell?

Install EasyShell by running: npx -y @easyshell-ai/easyshell

What MCP clients work with EasyShell?

EasyShell works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep EasyShell docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare