mcp-server-commands

runProcess 도구

runProcess 도구는 호스트 머신에서 프로세스를 실행합니다. 이를 호출하는 방법은 상호 배타적인 두 가지가 있습니다:

1. command_line (문자열) — 시스템의 기본 셸을 통해 실행됩니다(bash/fish/pwsh 등에 입력하는 것과 동일). 파이프, 리다이렉트, 변수 확장과 같은 셸 기능이 모두 작동합니다.

2. argv (문자열 배열) — 직접 실행 파일을 호출합니다. argv[0]은 실행 파일이며, 나머지는 인수입니다. 셸 해석이 없습니다.

두 가지를 동시에 전달할 수는 없습니다. 도구는 제공한 매개변수를 통해 셸 사용 여부를 추론합니다.

모델이 시스템에서 특정 셸을 사용하도록 하려면 시스템 프롬프트에 나열하는 것이 좋습니다. 또는 도구 지침에 포함할 수도 있지만, 모델은 시스템 프롬프트의 예시에 더 주의를 기울이는 경향이 있습니다.

문제가 발생하면 알려주세요!

Related MCP server: buildkite-mcp-server

도구

도구는 LLM이 요청하기 위한 것입니다. Claude Sonnet 3.5는 run_process를 지능적으로 사용합니다. 또한 초기 테스트 결과 Groq Desktop with MCP 및 llama4 모델에서 유망한 결과를 보여줍니다.

현재는 모든 것을 제어하는 하나의 명령어가 있습니다!

• run_process - 명령어 실행 (예: hostname, ls -al, echo "hello world" 등)

  • STDOUT 및 STDERR을 텍스트로 반환

  • 선택적 stdin 매개변수를 통해 LLM이 다음을 수행할 수 있음

    • fish, bash, zsh, python과 같은 명령어에 STDIN을 통해 스크립트 전달

    • stdin의 텍스트를 사용하여 cat >> foo/bar.txt로 파일 생성

[!WARNING] 이 서버가 실행하도록 요청하는 내용에 주의하세요! Claude Desktop 앱에서는 각 명령어를 검토할 수 있도록 Approve Once(이 채팅에 대해 허용 아님)를 사용하고, 명령어를 신뢰할 수 없는 경우 Deny를 사용하세요. 권한은 서버를 실행하는 사용자에 의해 결정됩니다. sudo로 실행하지 마세요.

비디오 가이드

프롬프트

프롬프트는 사용자가 채팅 기록에 포함하기 위한 것입니다 (예: Zed의 슬래시 명령어 사용, AI 채팅 패널에서)

• run_process - 명령어 출력과 함께 프롬프트 메시지 생성

• 참고: 이것은 주로 학습 연습용이었습니다... 저는 이것을 사용자가 요청한 도구 호출로 봅니다. 즉, 명령어를 실행하고 그 결과를 모델에 전달하기 위한 템플릿이라는 뜻입니다!

개발

의존성 설치:

npm install

서버 빌드:

npm run build

자동 재빌드를 포함한 개발:

npm run watch

설치

Claude Desktop에서 사용하려면 서버 설정을 추가하세요:

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

Groq Desktop (베타, macOS)은 ~/Library/Application Support/groq-desktop-app/settings.json을 사용합니다.

게시된 npm 패키지 사용

이 워크플로우를 사용하여 mcp-server-commands로 npm에 게시되었습니다.

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"]
    }
  }
}

로컬 빌드 사용 (저장소 체크아웃)

npm run build를 실행해야 합니다.

{
  "mcpServers": {
    "mcp-server-commands": {
      // works b/c of shebang in index.js
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

로컬 모델

• 대부분의 모델은 사용자를 대신해 명령어를 실행할 수 없다고 학습되었습니다.

  • 때로는 주저 없이 도구를 사용하기도 하지만, 때로는 설득이 필요합니다.

  • 시스템 프롬프트나 프롬프트 템플릿을 사용하여 사용자의 요청을 따르도록 지시하세요. 다시 확인하지 않고 run_process를 사용하도록 하는 것도 포함됩니다.

• Ollama는 로컬에서 모델을 실행하는 좋은 방법입니다 (Open-WebUI와 함께).

# NOTE: make sure to review variants and sizes, so the model fits in your VRAM to perform well!

# Probably the best so far is [OpenHands LM](https://www.all-hands.dev/blog/introducing-openhands-lm-32b----a-strong-open-coding-agent-model)
ollama pull https://huggingface.co/lmstudio-community/openhands-lm-32b-v0.1-GGUF

# https://ollama.com/library/devstral
ollama pull devstral

# Qwen2.5-Coder has tool use but you have to coax it
ollama pull qwen2.5-coder

HTTP / OpenAPI

서버는 STDIO 전송 방식으로 구현되었습니다. HTTP의 경우, OpenAPI 호환 웹 서버 인터페이스를 위해 mcpo를 사용하세요. 이는 Open-WebUI와 함께 작동합니다.

uvx mcpo --port 3010 --api-key "supersecret" -- npx mcp-server-commands

# uvx runs mcpo => mcpo run npx => npx runs mcp-server-commands
# then, mcpo bridges STDIO <=> HTTP

[!WARNING] open-webui와 함께 mcpo를 잠시 사용해 보았는데, 보안 문제를 확인하시기 바랍니다.

로깅

Claude Desktop 앱은 로그를 ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log에 기록합니다.

기본적으로 중요한 메시지(예: 오류)만 기록됩니다. 더 많은 메시지를 보려면 서버 구성 시 args에 --verbose를 추가하세요.

참고로, 로그는 Claude Desktop이 로그 파일로 라우팅하는 STDERR로 기록됩니다. 향후에는 잘 형식화된 로그 메시지가 STDIO 전송을 통해 MCP 클라이언트(참고: Claude Desktop 앱 아님)로 기록될 것으로 예상합니다.

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector 사용을 권장합니다:

npm run inspector

Inspector는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.