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

시간 초과 시:

cli-exec

특정 디렉토리의 단일 명령:

여러 명령(모두 동일한 작업 디렉토리에서 실행):

설치

선택적으로 npm에서 설치:

아니면 구성에서 npx를 사용하세요

Cline VSCode 확장 프로그램용

%APPDATA%/Code - Insiders/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json 에 추가:

클로드 데스크탑용

적절한 구성 파일에 추가:

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

특수 Windows 구성

Windows에서 ENOENT spawn npx 문제가 발생하면 전체 경로를 지정하는 다음 대체 구성을 사용하세요.

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

디버깅

MCP 서버는 stdio를 통해 통신하기 때문에 디버깅이 어려울 수 있습니다. MCP Inspector는 다음과 같은 유용한 디버깅 도구를 제공합니다.

이렇게 하면 브라우저에서 검사기에 액세스할 수 있는 URL이 제공되며, 이를 통해 다음을 수행할 수 있습니다.

• 모든 MCP 메시지 보기

• 요청/응답 페이로드 검사

• 테스트 도구를 대화형으로

• 서버 상태 모니터링

오류 처리

서버에는 포괄적인 오류 처리 기능이 포함되어 있습니다.

• 모든 도구 매개변수에 대한 입력 검증

• 구조화된 오류 응답

• 명령 시간 초과 처리

• 작업 디렉토리 검증

• 깨끗한 출력을 위한 ANSI 코드 스트리핑

기술적 세부 사항

• TypeScript 및 MCP SDK로 구축됨

• 안정적인 명령 실행을 위해 execa를 사용합니다.

• 기본 명령 시간 초과: 5분

• Windows 및 Unix 계열 시스템을 지원합니다(예: 'dir' 대 'ls' 등 OS에 맞는 명령을 사용하세요)

• 명령을 순차적으로 실행하고 첫 번째 실패 시 중지합니다.

• 각 명령은 지정된 작업 디렉토리에서 독립적으로 실행됩니다.