Command Execution MCP Server for Claude Desktop

Claude Desktop 向けコマンド実行 MCP サーバー

概要

コマンド実行 MCP（Model Context Protocol）サーバーは、Claude がローカルシステム上でシェルコマンドを直接実行できる、安全で制御されたツールです。このサーバーを使うと、Claude のインターフェースを通じてコンピューターのコマンドラインを安全かつ柔軟に操作できます。

主な機能

• 安全なコマンド実行：組み込みの安全性チェックを適用してシェルコマンドを実行します
• 作業ディレクトリの指定：特定のディレクトリ内でコマンドを実行できます
• クロスプラットフォーム対応：macOS などの Unix 系システムで動作します
• 詳細なエラー処理：コマンドの実行状況について詳細な情報を提供します
• タイムアウトとバッファー制限：制御不能になったり、リソースを過剰に消費したりするコマンドを防ぎます

セキュリティ対策

このサーバーでは、複数段階のセキュリティ対策を実施しています。

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

   • rm -rf、sudo など、潜在的に有害なコマンドの実行を防ぎます
   • システムの整合性を損なう可能性のあるコマンドをブロックします

2. 実行の制約

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

対応ツール

1. execute-command

作業ディレクトリを任意で指定して、シェルコマンドを実行します。

パラメーター：

• command（必須）：実行するシェルコマンド
• 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 Package Manager）

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 秒です
• 出力は 1 MB に制限されています
• システムにとって重要な一部のコマンドはブロックされます

貢献

貢献を歓迎します！GitHub リポジトリにプルリクエストを送信するか、Issue を作成してください。

ライセンス

MIT License

サポート

問題の報告や機能リクエストについては、GitHub Issue を作成してください。