MCP Shell Server

🚀 MCP Shell Server

安全なコマンド実行サーバで、モデルコンテキストプロトコル（MCP）を実装しています。このサーバは、承認されたシェルコマンドのリモート実行を許可し、stdinを介した入力の伝達もサポートします。

🚀 クイックスタート

MCP Shell Serverは、安全なコマンド実行サーバで、モデルコンテキストプロトコル（MCP）を実装しています。このサーバを使用することで、承認されたシェルコマンドをリモートで実行でき、stdinを介して入力を伝達することもできます。

✨ 主な機能

• 安全なコマンド実行：承認されたコマンドのみが実行できます。
• 標準入力のサポート：stdinを介してコマンドに入力を伝達できます。
• 完全な出力：stdout、stderr、終了ステータス、および実行時間を返します。
• シェル演算子の安全性：シェル演算子（; , &&, ||, |）の後にコマンドを検証します。
• タイムアウト制御：コマンドの最大実行時間を設定できます。

📦 インストール

ローカルバージョンのインストール

pip install mcp-shell-server

💻 使用例

基本的な使用法

Claude.appでのMCPクライアントの設定（リリースバージョン）

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shell": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}

Claude.appでのMCPクライアントの設定（ローカルバージョン）

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shell": {
      "command": "uv",
      "args": [
        "--directory",
        ".",
        "run",
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    }
  }
}

サーバの起動

ALLOW_COMMANDS="ls,cat,echo" uvx mcp-shell-server
# またはエイリアスを使用
ALLOWED_COMMANDS="ls ,echo, cat" uvx mcp-shell-server

ALLOW_COMMANDS（またはそのエイリアス ALLOWED_COMMANDS）環境変数は、実行を許可するコマンドを指定します。コマンドはカンマで区切り、空白を含めることができます。

ALLOW_COMMANDSの有効な形式：

ALLOW_COMMANDS="ls,cat,echo"          # 基本形式
ALLOWED_COMMANDS="ls ,echo, cat"      # 空白を含む形式

高度な使用法

リクエストの例

{
  "id": "string",
  "method": "shell",
  "params": {
    "command": "string"
  }
}

📚 ドキュメント

セキュリティに関する注意事項

• すべてのコマンド実行は制御された環境で行われます。
• 危険なシステムコールやファイル操作は禁止されています。

開発環境の設定

• Python 3.11以上
• mcp>=1.1.0

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。