Shell MCP Server

シェルMCPサーバー

セキュアなシェルコマンド実行機能を提供するモデルコンテキストプロトコル（MCP）のNode.js実装です。このサーバーにより、AIモデルはセキュリティ対策が組み込まれた制御された環境でシェルコマンドを実行できます。Claude Desktopと簡単に統合でき、Claudeをシェルに接続できます。

特徴

• MCP準拠のサーバー実装
• ブラックリスト保護による安全なコマンド実行
• コマンドの存在検証
• 標準I/Oベースのトランスポート
• エラー処理と正常なシャットダウン

インストール

npx mcp-shellを実行します。

Claude Desktopに追加するには、 npx mcp-shell config実行します。または、 npx -y mcp-shell手動で設定に追加します。

Claude Desktop を起動 (または再起動) すると、ランディング ページに MCP ツールが表示されます。

セキュリティ機能

サーバーはいくつかのセキュリティ対策を実装しています。

1. コマンドブラックリスト
   • 危険なシステムコマンドの実行を防止します
   • 重要なシステム変更へのアクセスをブロック
   • ファイルシステムの破壊から保護します
   • 権限昇格を防止
2. コマンド検証
   • 実行前にコマンドの存在を確認する
   • ブラックリストを検証する
   • 無効なコマンドに対して明確なエラーメッセージを返します

利用可能なツール

サーバーは次のツールを 1 つ提供します。

実行コマンド

シェル コマンドを実行し、その出力を返します。

入力スキーマ:

応答：

• 成功: コマンド出力はプレーンテキストとして出力されます
• エラー: エラー メッセージがプレーン テキストで表示されます

ブラックリストに登録されたコマンド

次のコマンド カテゴリはセキュリティ上の理由によりブロックされています。

• ファイルシステム破壊コマンド (rm、rmdir、del)
• ディスク/ファイルシステムコマンド（format、mkfs、dd）
• 権限/所有権コマンド (chmod、chown)
• 権限昇格コマンド (sudo、su)
• コード実行コマンド (exec、eval)
• システム通信コマンド（write、wall）
• システム制御コマンド (シャットダウン、再起動、初期化)

エラー処理

サーバーには包括的なエラー処理が含まれています。

• コマンドが見つからないエラー
• ブラックリストに登録されたコマンドエラー
• 実行エラー
• MCPプロトコルエラー
• SIGINT による正常なシャットダウン

実装の詳細

サーバーは以下を使用して構築されます:

• モデルコンテキストプロトコルSDK
• 通信用のStdioServerTransport
• コマンド実行用のexeca
• コマンド検証のためのコマンド存在

発達

セキュリティ設定を変更するには、次の操作を行います。

1. ブロックされたコマンドを調整するには、 BLACKLISTED_COMMANDSセットを編集します。
2. 追加の検証ルールを追加するには、 validateCommand関数を変更します。
3. CallToolRequestSchemaハンドラーのコマンド解析ロジックを強化します