MCP Cli Exec

🚀 MCP-CLI-EXEC サーバー

強力な CLI コマンド実行 MCP サーバーです。構造化された出力でシェルコマンドを実行することができます。このパッケージはコマンド実行機能に特化しており、他の MCP CLI ツールとは異なります。

✨ 主な機能

ツール

cli-exec-raw

生の CLI コマンドを実行し、構造化された出力を返します。

• コマンド文字列とオプションのタイムアウト時間（デフォルト: 5 分）を受け取ります。
• stdout、stderr、および終了コードを含む詳細な実行結果を返します。
• エラーを柔軟に処理し、構造化されたエラー応答を提供します。

cli-exec

指定された作業ディレクトリで 1 つまたは複数の CLI コマンドを実行します。

• 単一のコマンド、&& で連結されたコマンドチェーン、またはコマンド配列をサポートします。
• すべてのコマンドは指定された作業ディレクトリで実行されます。
• 各コマンドの詳細な結果を返します：
  • 成功/失敗のステータス
  • 終了コード
  • stdout と stderr（ANSI コードを除去）
  • 実行時間
  • 作業ディレクトリ
• 最初のコマンドが失敗した時点で停止します。
• 各コマンドにはオプションのタイムアウト時間（デフォルト: 5 分）があります。

⚠️ 重要提示

実行コンテキストの制限により、各コマンドは独立して実行されます。コマンド内のディレクトリ変更（cd）は後続のコマンドに影響しません。すべてのコマンドは最初に指定された作業ディレクトリで実行されます。

出力形式

コマンドは構造化された結果を返します。これには以下が含まれます：

• 成功/失敗のステータス
• 終了コード
• stdout と stderr（ANSI コードを除去）
• 実行時間
• 作業ディレクトリ
• エラーがある場合は詳細なエラー情報

💻 使用例

基本的な使用法

cli-exec-raw

単純なコマンド実行：

{
  "command": "echo Hello World"
}

タイムアウト設定付き：

{
  "command": "long-running-script.sh",
  "timeout": 300000
}

cli-exec

特定のディレクトリで単一のコマンドを実行：

{
  "workingDirectory": "/path/to/project",
  "commands": "npm install"
}

同じ作業ディレクトリで複数のコマンドを実行：

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

📦 インストール

npm からインストールすることができます：

npm install -g mcp-cli-exec
# または pnpm を使用する場合
pnpm add -g mcp-cli-exec

または、直接構成で npx を使用することもできます。

Cline VSCode 拡張機能の場合

%APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/exec に追加します：

{
  "command": "echo Hello World"
}

Claude Desktop の場合

Claude Desktop の設定に追加します：

{
  "workingDirectory": "C:\\project",
  "commands": [
    "dir /b",
    "npm run build"
  ]
}

🔧 技術詳細

• デフォルトのタイムアウト時間: 5 分
• 外部コマンドの実行に execa を使用しています。
• 各コマンドは独立して実行され、相互に影響を与えません。