Shell MCP

🚀 Shellコマンド実行MCPサーバー

大規模言語モデル（LLM）用の安全なShellコマンド実行MCPサーバーです。

LLMに安全なShellコマンド実行機能を提供するMCPサーバーの実装です。

✨ 主な機能

• 安全な実行：ホワイトリストに登録されたコマンドとパラメータのみを許可します。
• リソース制御：メモリとCPUの使用状況を監視します。
• タイムアウト制御：長時間実行されるコマンドを自動的に終了します。
• サイズ制限：出力結果のサイズを制限して安全性を確保します。
• MCP統合：Claudeやその他のMCP互換LLMと一緒に使用できます。

📦 インストール

npm install @kevinwatt/shell-mcp

Dive Desktopとの設定

1. Dive Desktopで「+ MCPサーバーを追加」をクリックします。
2. 以下の設定をコピーして貼り付けます。

{
  "mcpServers": {
    "shell": {
      "command": "npx",
      "args": [
        "-y",
        "@kevinwatt/shell-mcp"
      ]
    }
  }
}

📚 ドキュメント

• shell_ls, shell_pwd, shell_df など
  • 検証済みのShellコマンドを実行します。
  • 入力：
    • command (文字列、必須)：実行するコマンド
    • args (配列、オプション)：コマンドのパラメータ
    • timeout (数値、オプション)：実行のタイムアウト時間（単位：ミリ秒）

💻 使用例

あなたのLLMに以下の操作を実行させます。

"shell_pwdを使用して現在のディレクトリを表示する"
"shell_lsと-lパラメータを使用してファイルをリストする"
"shell_dfと-hパラメータを使用してディスク使用状況を確認する"

手動起動

必要に応じて、サーバーを手動で起動することができます。

npx @kevinwatt/shell-mcp

要件

• Node.js 18+
• MCP互換のLLMサービス

開発

# 依存関係をインストールする
npm install

# ウォッチモード
npm run watch

# テストを実行する
npm test

# コードスタイルを検証する
npm run lint

📄 ライセンス

MIT © 德维·严

キーワード

• mcp
• shell
• command
• claude
• llm
• 自動化

利用可能なコマンド

以下のShellコマンドが利用可能です。

注意：すべてのコマンドはホワイトリストで検証された後に実行されます。