local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables running shell commands with structured output, including support for single commands, chained commands, or arrays of commands in specified working directories. Returns detailed execution results with stdout, stderr, exit codes, and execution duration.

mcp-cli-exec MCP サーバー

強力な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
# or with pnpm
pnpm add -g mcp-cli-exec

または、設定でnpxを使用するだけです

Cline VSCode拡張機能

%APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.jsonに追加します:

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

クロードデスクトップ向け

適切な設定ファイルに追加します:

Windows: %APPDATA%/Claude/claude_desktop_config.json MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "npx",
      "args": ["-y", "mcp-cli-exec"]
    }
  }
}

特別なWindows構成

Windows で ENOENT spawn npx の問題が発生した場合は、完全なパスを指定する次の代替構成を使用します。

{
  "mcpServers": {
    "mcp-cli-exec": {
      "command": "C:\\Users\\jim\\AppData\\Roaming\\nvm\\v22.1.0\\node.exe",
      "args": [
        "C:\\Users\\jim\\AppData\\Roaming\\npm\\node_modules\\npm\\bin\\npx-cli.js",
        "-y",
        "mcp-cli-exec"
      ]
    }
  }
}

発達

依存関係をインストールします:

pnpm install

サーバーを構築します。

pnpm run build

自動リビルドを使用した開発の場合:

pnpm run watch

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCP Inspectorは便利なデバッグツールを提供します。

pnpm run inspector

これにより、ブラウザでインスペクタにアクセスするための URL が提供され、次の操作を実行できます。

すべてのMCPメッセージを表示
リクエスト/レスポンスペイロードを検査する
ツールをインタラクティブにテストする
サーバーの状態を監視する

エラー処理

サーバーには包括的なエラー処理が含まれています。

すべてのツールパラメータの入力検証
構造化されたエラー応答
コマンドタイムアウト処理
作業ディレクトリの検証
きれいな出力のための ANSI コード除去

技術的な詳細

TypeScriptとMCP SDKを使用して構築
信頼性の高いコマンド実行のためにexecaを使用する
デフォルトのコマンドタイムアウト: 5分
Windows および Unix 系システムをサポートします (OS に応じて適切なコマンドを使用します (例: 'dir' と 'ls'))
コマンドを順番に実行し、最初の失敗で停止します
各コマンドは指定された作業ディレクトリ内で独立して実行されます

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

構造化された出力でシェルコマンドを実行できる CLI コマンド実行サーバー。stdout、stderr、終了コード、実行時間などの詳細な実行結果を提供します。

Related Resources

Reddit Discussion about this server

mcp-cli-exec MCP Server

Integrations

mcp-cli-exec MCP サーバー

特徴

ツール

cli-exec-raw

cli-exec

出力形式

使用例

cli-exec-raw

cli-exec

インストール

Cline VSCode拡張機能

クロードデスクトップ向け

特別なWindows構成

発達

デバッグ

エラー処理

技術的な詳細

Tools

Related Resources

Appeared in Searches