Shell-MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

シェル-MCP

シェルコマンド実行MCPサーバー

LLM にセキュア シェル コマンド実行機能を提供する MCP サーバー実装。

特徴

  • セキュア実行: ホワイトリストに登録されたコマンドと引数のみ
  • リソース制御: メモリとCPUの使用状況の監視
  • タイムアウト制御: 長時間実行コマンドの自動終了
  • サイズ制限:安全のための出力サイズ制限
  • MCP 統合: Claude やその他の MCP 互換 LLM と連携

インストール

npm install @kevinwatt/shell-mcp

Dive Desktopでの設定

  1. Diveデスクトップで「+ MCPサーバーを追加」をクリックします。
  2. 次の設定をコピーして貼り付けます。
{ "mcpServers": { "shell": { "command": "npx", "args": [ "-y", "@kevinwatt/shell-mcp" ] } } }

ツールドキュメント

  • shell_ls、shell_pwd、shell_df など。
    • ホワイトリストに登録されたシェルコマンドを実行する
    • 入力:
      • command (文字列、必須): 実行するコマンド
      • args (配列、オプション): コマンド引数
      • timeout (数値、オプション):実行タイムアウト(ミリ秒)

使用例

LLM に次のことを依頼してください。

"Show current directory using shell_pwd" "List files using shell_ls with -l argument" "Check disk usage using shell_df with -h argument"

手動スタート

必要に応じて、サーバーを手動で起動します。

npx @kevinwatt/shell-mcp

要件

  • Node.js 18歳以上
  • MCP対応LLMサービス

発達

# Install dependencies npm install # Watch mode npm run watch # Run tests npm test # Lint npm run lint

ライセンス

MIT © デウェイ・イェン

キーワード

  • マクピー
  • シェル
  • 指示
  • クロード
  • 法学博士
  • オートメーション

利用可能なコマンド

次のシェル コマンドが使用できます。

指示説明許可された引数
lsディレクトリの内容を一覧表示する-l、-a、-h、-R、--help、*
ファイルの内容を連結して表示する-n、-b、--help、*
パスワード現在の作業ディレクトリを表示なし
DFディスク使用量を表示-h、-T、--ヘルプ
エコー表示テキスト任意のテキスト
追伸プロセスステータスを表示-e、-f、-u、--help
無料メモリ使用量を表示-h、-m、-g、--help
稼働時間システムの稼働時間を表示なし
日付システムの日付と時刻を表示する+%Y-%m-%d、+%H:%M:%S、--ヘルプ
グレップファイル内のテキストパターンを検索する-i、-v、-n、-r、-l、--color、*
誰がログインしているか、何をしているかを表示する-h、-s、--no-header、--help
フーイズWHOISドメイン登録情報の照会-H、*
探すディレクトリ階層内のファイルを検索する-名前、-タイプ、-サイズ、-mtime、*
ネットスタットネットワーク接続情報-a、-n、-t、-u、-l、-p、--help
lspciPCIデバイスの一覧-v、-k、-mm、-nn、--help
lsusbUSBデバイスの一覧-v、-t、-d、-s、--help
掘るDNSルックアップユーティリティ+ショート、+トレース、+dnssec、@**
nslookupDNSレコードのクエリ-type=*、-query=**
ipネットワークデバイスとインターフェースを表示するアドレス、リンク、ルート、近隣、-br、*
どこですかバイナリ、ソース、マニュアルファイルを見つける-b、-m、-s、*

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Claude やその他の MCP 互換 LLM との統合用に設計された、リソースとタイムアウトの制御を備えたホワイトリスト シェル コマンドを実行するための安全な MCP サーバーです。

  1. Features
    1. Installation
      1. Configuration with Dive Desktop
        1. Tool Documentation
          1. Usage Examples
            1. Manual Start
              1. Requirements
                1. Development
                  1. License
                    1. Keywords
                      1. Available Commands
                        ID: jyubrnnudg