Easyshell

Name: Easyshell
Author: easyshell-ai

@easyshell-ai

关于 Easyshell

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

基本信息

分类

其他

许可证

MIT

运行时

java

传输方式

stdio

发布者

easyshell-ai

提交者

pong ping

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.