Easyshell

EasyShell MCP サーバー

EasyShell 用の Model Context Protocol サーバーです。ホストの管理、スクリプトの実行、複数ホストにまたがるタスクのオーケストレーション、AI による検査のスケジュール設定を行い、AI アシスタントからインフラストラクチャ操作にアクセスできます。

特長

• 3 段階にわたる 19 個のツール
• Tier 1 コア（6 個）：list_hosts、get_host_detail、execute_script、get_task_detail、list_scripts、ai_chat
• Tier 2 管理（8 個）：list_recent_tasks、create_script、list_clusters、get_dashboard_stats、get_host_metrics、list_scheduled_tasks、trigger_inspection、get_inspect_reports
• Tier 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	ヘルスチェック

ツールの完全なリファレンス

Tier	ツール	用途
Core	list_hosts	ホストを一覧表示し、ステータスで絞り込みます。
Core	get_host_detail	ホストの詳細情報を取得します。
Core	execute_script	選択したホスト上でスクリプトの内容を実行します。
Core	get_task_detail	タスク実行結果の詳細を取得します。
Core	list_scripts	スクリプトライブラリのスクリプトを一覧表示します。
Core	ai_chat	自然言語による AI 操作のオーケストレーションを実行します。
Management	list_recent_tasks	最近の実行タスクを検索します。
Management	create_script	再利用可能なスクリプトを作成して保存します。
Management	list_clusters	ホストクラスター／グループを一覧表示します。
Management	get_dashboard_stats	プラットフォームの KPI と概要統計を取得します。
Management	get_host_metrics	ホストのメトリクス履歴を取得します。
Management	list_scheduled_tasks	設定済みの定期検査を一覧表示します。
Management	trigger_inspection	検査をただちに開始します。
Management	get_inspect_reports	AI 検査の分析レポートを読み取ります。
Advanced	manage_tags	ホストのタグと割り当てを管理します。
Advanced	query_audit_logs	監査ログとコンプライアンスログを検索します。
Advanced	approve_task	高リスクの操作を承認または却下します。
Advanced	send_notification	設定済みのチャネルに通知を送信します。
Advanced	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