Commandexecution

🚀 コマンド実行MCPサーバ - Claude Desktop版

コマンド実行MCP（モデルコンテキストプロトコル）サーバは、Claudeが直接あなたのローカルシステム上でshellコマンドを実行できる、安全で制御可能なツールです。このサーバは、Claudeのインターフェースを通じてコンピュータのコマンドラインと安全かつ柔軟にやり取りする方法を提供します。

✨ 主な機能

• 安全なコマンド実行：組み込みの安全チェック付きのshellコマンド実行
• 作業ディレクトリサポート：特定のディレクトリでコマンドを実行可能
• クロスプラットフォーム互換性：macOSやその他のUnix系システムに対応
• 完全なエラー処理：詳細なコマンド実行フィードバックを提供
• タイムアウトとバッファ制限：長時間実行またはリソースを大量に消費するコマンドを防止

🔒 セキュリティ対策

サーバは複数のレイヤーのセキュリティ保護を実装しています。

1. 危険なコマンドのブロック

   • rm -rf、sudo などの潜在的に危険なコマンドの実行を防止
   • システムの完全性を損なう可能性のあるコマンドの実行をブロック

2. 実行制限

   • 最大実行時間：30秒
   • 最大出力バッファサイズ：1MB
   • 作業ディレクトリの存在を検証

🛠️ サポートツール

1. execute-command

任意の作業ディレクトリでshellコマンドを実行します。

パラメータ:

• command (必須): 実行するshellコマンド
• workingDirectory (任意): コマンドを実行するディレクトリを指定

Claudeでの使用例:

execute-command with command="ls -la" and workingDirectory="/Users/yourusername/Documents"

2. simple-hello

挨拶を返す基本的なデモツールです。

パラメータ:

• name (任意): 挨拶する名前（デフォルトは "World"）

Claudeでの使用例:

simple-hello with name="Claude"

📦 インストール

1. 前提条件

• Node.js (v16 以上)
• Claude Desktop
• npm (Nodeパッケージマネージャー)

2. 依存関係のインストール

cd /path/to/command-execution-tool
npm install @modelcontextprotocol/sdk

3. Claude Desktopの設定

以下の内容をClaude Desktopの設定ファイルに追加します。

場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

設定ブロック:

{
  "mcpServers": {
    "command-execution": {
      "command": "node",
      "args": [
        "/full/path/to/command-execution-tool.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

注意: /full/path/to/command-execution-tool.js を実際のスクリプトのパスに置き換えてください。

💡 使用ガイド

• 慎重に行動：理解しているコマンドのみを実行してください。
• 安全を第一に：ツールは明らかに危険なコマンドをブロックします。
• 作業ディレクトリ：より制御された実行環境を得るために作業ディレクトリを指定してください。

⚠️ 制限事項

• 対話型コマンドはサポートされていません。
• 最大コマンド実行時間は30秒です。
• 出力は1MBに制限されています。
• 一部のシステム重要コマンドはブロックされます。

🤝 貢献

貢献を歓迎します！プルリクエストを提出するか、GitHubリポジトリで問題を開いてください。

📄 ライセンス

MITライセンス

🆘 サポート

問題や機能リクエストについては、GitHubで問題を開いてください。