Shell MCP Server

🚀 Shell MCP サーバー

Node.js をベースに実装されたモデルコンテキストプロトコル（MCP）のサービスで、安全なシェルコマンド実行機能を提供します。このサーバーは、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. コマンド検証

   • 実行前にコマンドが存在するか検証
   • ブラックリストをチェック
   • 無効なコマンドに対して明確なエラーメッセージを返す

💻 使用例

run_command

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

入力形式：

{
  "type": "object",
  "properties": {
    "command": { "type": "string" }
  }
}

応答：

• 成功：コマンド出力を純粋なテキストとして返す
• エラー：エラーメッセージを純粋なテキストとして返す

🚫 ブラックリストコマンド

以下のコマンドカテゴリは、セキュリティを確保するためにブロックされています。

• ファイルシステム破壊コマンド（rm, rmdir, del）
• ディスク/ファイルシステムコマンド（format, mkfs, dd）
• 権限/所有権コマンド（chmod, chown）
• 特権昇格コマンド（sudo, su）
• コード実行コマンド（exec, eval）
• システム通信コマンド（write, wall）
• システム制御コマンド（shutdown, reboot, init）

🛠️ エラー処理

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

• コマンドが見つからないエラー
• ブラックリストコマンドエラー
• 実行エラー
• MCP プロトコルエラー
• SIGINT 信号を受け取ったときのエレガントなシャットダウン

🔧 技術詳細

サーバーは以下の技術を使用して構築されています。

• モデルコンテキストプロトコル SDK
• StdioServerTransport を使用した通信
• execa を使用したコマンド実行
• command-exists を使用したコマンド存在性検証

🛠️ 開発に関する説明

セキュリティ設定を変更するには、以下の操作を行うことができます。

1. BLACKLISTED_COMMANDS セットを編集して、ブロックするコマンドを調整する
2. validateCommand 関数を変更して、追加の検証ルールを追加する
3. CallToolRequestSchema ハンドラー内のコマンド解析ロジックを改善する