Command Executor MCP Server

🚀 コマンド実行器 MCP サーバ

Model Context Protocol サーバは、事前に承認されたコマンドを安全に実行するために使用されます。

🚀 クイックスタート

Model Context Protocol サーバは、事前に承認されたコマンドを安全に実行するために使用されます。以下に、サーバの使用方法や設定について説明します。

🎥 デモ

https://github.com/user-attachments/assets/ed763a12-b685-4e0b-b9a5-bc948a590f51

✨ 主な機能

• 事前承認されたコマンドリストを使用した安全なコマンド実行
• 環境変数を通じた許可コマンドの設定
• TypeScript と MCP SDK を使用して構築
• stdio を通じた通信によるシームレスな統合
• エラー処理とセキュリティ検証を備える
• リアルタイムのコマンド出力ストリーム

📦 インストール

依存関係のインストール：

npm install

サーバのビルド：

npm run build

開発モード（自動再構築）：

npm run watch

📚 ドキュメント

🔒 許可されるコマンド

デフォルトでは、以下のコマンドが許可されています：

• git
• ls
• mkdir
• cd
• npm
• npx
• python

ALLOWED_COMMANDS 環境変数を設定することで、許可するコマンドをカスタマイズできます：

export ALLOWED_COMMANDS=git,ls,mkdir,python

🔌 Claude デスクトップとの統合

Claude Desktop と一緒に使用するには、サーバ設定を追加します。

MacOS の場合：

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

Windows の場合：

%APPDATA%/Claude/claude_desktop_config.json

設定例：

{
  "mcpServers": {
    "command-executor": {
      "command": "/path/to/command-executor/build/index.js"
    }
  }
}

🔧 技術詳細

🛡️ セキュリティに関する考慮事項

コマンド実行器サーバは、いくつかのセキュリティ対策を実装しています：

1. 事前承認されたコマンドリスト

   • 明示的に許可されたコマンドのみが実行できます。
   • デフォルトのリストは厳格で、セキュリティに配慮しています。
   • コマンドはプレフィックス検証により注入を防止します。

2. コマンド検証

   • コマンドのプレフィックス検証により、コマンド注入を防止します。
   • shell を使用せずに実行することで、セキュリティを向上させます。
   • 環境変数は適切にクリーニングされます。

3. ランタイムセキュリティ

   • CAP（コンテナ化アプリケーション保護）ポリシーを使用して、プロセスの権限を制限します。
   • root ユーザーではなく、一般ユーザーとして実行します。
   • パストラバーサル攻撃を防止します。

🛠️ ビルド方法

コマンド実行器をビルドするには、Node.js と npm を使用します：

npm install
npm run build

🤝 貢献方法

1. リポジトリをフォークしてクローンします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. 新しいプルリクエストを作成します。

📄 ライセンス

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