Secure Shell Executor

🚀 MCP Shell Server

このサーバーは、承認されたシェルコマンドを安全に実行し、stdinを介した入力の受け渡しもサポートしています。モデルコンテキストプロトコル（MCP）を実装しており、リモートで検証済みのシェルコマンドを実行することができます。

🚀 クイックスタート

このセクションでは、Claude.appでのクライアント設定、サーバーのインストールと起動、使用方法について説明します。

Claude.appでのクライアント設定

公開バージョン

code ~/Library/Application\ Support/Claude/claude.yaml

backend:
  class: mcp_shell_server.Backend
  config:
    server_uri: http://localhost:5000
    max_timeout: 3600

ローカルバージョン

poetry install
poetry run mcp-shell-server

インストール

依存関係のインストール

pip install -e ".[test]"

サーバーの起動

uvicorn main:app --reload

インストールの検証

以下のコマンドを実行して、インストールが成功したことを確認します。

mcp-shell-server --version

使用方法

基本的なコマンドの実行

リクエスト例：

{
  "command": ["echo", "Hello, World!"],
  "stdin": null,
  "directory": "/",
  "timeout": 30
}

レスポンス例：

{
  "stdout": "Hello, World!\n",
  "stderr": "",
  "status": 0,
  "execution_time": 0.123456
}

標準入力を伴うコマンド

リクエスト例：

{
  "command": ["tr", "a-z", "A-Z"],
  "stdin": "hello world\n",
  "directory": "/tmp",
  "timeout": 60
}

✨ 主な機能

• 安全なコマンド実行：信頼できるコマンドのみを実行できます。
• 標準入力サポート：stdinを介してコマンドに入力を提供できます。
• 包括的な出力：stdout、stderr、終了ステータスコード、および実行時間を返します。
• シェル演算子の検証：シェル演算子（;、&&、||、|）を使用する場合でも、コマンドの検証が行われます。
• タイムアウト制御：コマンドに最大実行時間を設定できます。

📚 ドキュメント

リクエストパラメータ

レスポンスパラメータ

🔧 技術詳細

開発環境のセットアップ

1. リポジトリをクローンします。

git clone https://github.com/yourusername/mcp-shell-server.git
cd mcp-shell-server

2. 依存関係をインストールします（テスト要件を含む）。

pip install -e ".[test]"

テストの実行

pytest

📄 ライセンス

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

📋 システム要件

• Python 3.11以上
• mcp >= 1.1.0