Easyshell

EasyShell MCP 服务

EasyShell 的 Model Context Protocol 服务：管理主机、执行脚本、编排多主机任务、安排 AI 巡检，并通过 AI 助手访问基础设施运维功能。

功能

• 提供 19 个工具，分为 3 个层级
• 第 1 层 核心功能（6 个）：list_hosts、get_host_detail、execute_script、get_task_detail、list_scripts、ai_chat
• 第 2 层 管理功能（8 个）：list_recent_tasks、create_script、list_clusters、get_dashboard_stats、get_host_metrics、list_scheduled_tasks、trigger_inspection、get_inspect_reports
• 第 3 层 高级功能（5 个）：manage_tags、query_audit_logs、approve_task、send_notification、search_knowledge

快速开始

Claude Desktop

在 MCP 配置中添加：

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

Cursor

在 Cursor MCP 设置中使用相同的 MCP 服务配置块。

OpenCode

在 OpenCode MCP 配置中使用相同的 MCP 服务配置块。

配置

变量	必填	描述
EASYSHELL_URL	是	EasyShell 服务 API 端点（例如 http://localhost:18080）。
EASYSHELL_USER	是	EasyShell 用户名。
EASYSHELL_PASS	是	EasyShell 密码。

传输模式

stdio（默认）

适用于 Claude Desktop、Cursor、OpenCode 和其他本地 AI 客户端：

npx -y @easyshell/mcp-server

HTTP（SSE + Streamable HTTP）

适用于远程部署、Smithery.ai 或基于浏览器的客户端：

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

绑定到所有网络接口以供远程访问：

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

端点：

端点	方法	协议
/mcp	POST / GET / DELETE	Streamable HTTP（2025-03-26）
/sse	GET	旧版 SSE（2024-11-05）
/messages?sessionId=<id>	POST	旧版 SSE 消息处理器
/health	GET	健康检查

完整工具参考

层级	工具	用途
核心	list_hosts	列出主机并按状态筛选。
核心	get_host_detail	获取主机详细信息。
核心	execute_script	在所选主机上执行脚本内容。
核心	get_task_detail	获取详细的任务执行结果。
核心	list_scripts	列出脚本库中的脚本。
核心	ai_chat	执行自然语言 AI 运维编排。
管理	list_recent_tasks	查询最近执行的任务。
管理	create_script	创建并保存可重复使用的脚本。
管理	list_clusters	列出主机集群／组。
管理	get_dashboard_stats	获取平台 KPI 和概览统计数据。
管理	get_host_metrics	获取主机指标历史记录。
管理	list_scheduled_tasks	列出已配置的定时巡检。
管理	trigger_inspection	立即触发巡检。
管理	get_inspect_reports	读取 AI 巡检分析报告。
高级	manage_tags	管理主机标签及其分配。
高级	query_audit_logs	搜索审计和合规日志。
高级	approve_task	批准或拒绝高风险操作。
高级	send_notification	向已配置的渠道发送通知。
高级	search_knowledge	搜索运维知识库。

自动安装

npx @easyshell/mcp-server --install

开发

npm ci
npm run build
npm run test
npm run inspector

链接

• 文档：https://docs.easyshell.ai
• Discord：https://discord.gg/akQqRgNB6t
• GitHub：https://github.com/easyshell-ai/easyshell