Tumf 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\ 支持/Claude/claude_desktop_config.json

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

ローカルバージョン

code ~/Library/Application\ 支持/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の形式：

• ls
• cat
• echo

高度な使用法

依存関係のインストール

pip install mcp-shell-server

サーバの起動

mcp-shell-server start --port 8000

リクエストの送信

curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{"command": "ls", "args": ["-a"]}'

🔧 技術詳細

セキュリティ対策

• すべてのコマンド実行はサンドボックス内で行われます。
• 危険な操作（ファイルシステムの変更など）は禁止されています。
• リソースの使用が制限されています。

要件

• Python 3.11以上
• mcp>=1.1.0

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。