mcp-cli-exec MCP 서버

구조화된 출력을 통해 셸 명령을 실행할 수 있는 강력한 CLI 명령 실행 MCP 서버입니다. 이 패키지는 명령 실행 기능에 중점을 두어 다른 MCP CLI 도구와 차별화됩니다.

특징

도구

cli-exec-raw

원시 CLI 명령을 실행하고 구조화된 출력을 반환합니다.

명령 문자열과 선택적 시간 초과(기본값: 5분)를 사용합니다.
stdout, stderr, 종료 코드를 포함한 자세한 실행 결과를 반환합니다.
구조화된 오류 응답으로 오류를 우아하게 처리합니다.

cli-exec

특정 작업 디렉토리에서 하나 이상의 CLI 명령을 실행합니다.

단일 명령, 체인 명령 또는 명령 배열을 지원합니다.
모든 명령은 지정된 작업 디렉토리에서 실행됩니다.
각 명령에 대한 자세한 결과를 반환합니다.
- 성공/실패 상태
- 종료 코드
- stdout 및 stderr(ANSI 코드 제거됨)
- 실행 기간
- 작업 디렉토리
첫 번째 명령 실패 시 중지
명령당 선택적 시간 초과(기본값: 5분)

참고: 실행 컨텍스트 제한으로 인해 각 명령은 독립적으로 실행됩니다. 명령 내에서 디렉터리를 변경(cd)해도 이후 명령에는 영향을 미치지 않습니다. 모든 명령은 처음 지정된 작업 디렉터리에서 실행됩니다.

출력 형식

명령은 다음을 포함한 구조화된 결과를 반환합니다.

성공/실패 상태
종료 코드
stdout 및 stderr(ANSI 코드 제거됨)
실행 기간
작업 디렉토리
해당되는 경우 자세한 오류 정보

사용 예

cli-exec-raw

간단한 명령 실행:

지엑스피1

시간 초과 시:

{
  "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 계열 시스템을 지원합니다(예: 'dir' 대 'ls' 등 OS에 맞는 명령을 사용하세요)
명령을 순차적으로 실행하고 첫 번째 실패 시 중지합니다.
각 명령은 지정된 작업 디렉토리에서 독립적으로 실행됩니다.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

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

Tools

stdout, stderr, 종료 코드, 실행 기간을 포함한 자세한 실행 결과를 제공하여 셸 명령을 구조화된 출력으로 실행할 수 있는 CLI 명령 실행 서버입니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-shell-server
tumf
A
security
A
license
A
quality
A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
Last updated -
1
74
Python
MIT License
mcp-wcgw
rusiaaman
A
security
A
license
A
quality
Shell and file edit capabilities tightly coupled to provide a powerful coding experience. You can work with different modes: architect and code-writer for separate plan and implementation phase. You can get it to invoke any cli command, e.g., compiling, type checking, linting, github cli, python
Last updated -
6
510
Python
Apache 2.0
Shell MCP Server
blazickjp
-
security
A
license
-
quality
A secure server that enables AI applications to execute shell commands in specified directories, supporting multiple shell types (bash, sh, cmd, powershell) with built-in security features like directory isolation and timeout control.
Last updated -
9
Python
Apache 2.0
Specif-ai MCP Server
vj-presidio
A
security
F
license
A
quality
A CLI tool that runs a Model Context Protocol server over stdio, enabling interaction with specification documents like business requirements, product requirements, and user stories for the Specif-ai platform.
Last updated -
9
0
TypeScript

View all related MCP servers

mcp-cli-exec MCP Server