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"
 ]
}

Related MCP server: MCP Server

インストール

オプションで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'))

• コマンドを順番に実行し、最初の失敗で停止します

• 各コマンドは指定された作業ディレクトリ内で独立して実行されます

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• cli-execC
• cli-exec-rawC