Shell MCP 서버

셸 명령 실행 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 셸 명령을 실행하고 제어된 방식으로 출력을 수신할 수 있습니다.

사용 가능한 도구

• execute_command - 셸 명령을 실행하고 출력을 반환합니다.

  • 필수 인수:

    • command (문자열): 실행할 쉘 명령

  • 보고:

    • 명령 결과에는 다음이 포함됩니다.

      • command : 실행된 명령

      • output : stdout과 stderr 출력 결합

      • return_code : 명령 실행 반환 코드

Related MCP server: PermShell MCP

설치

uv 사용(권장)

uv 사용하면 별도의 설치가 필요하지 않습니다. uvx 사용하여 mcp-server-shell을 직접 실행합니다.

PIP 사용

또는 pip를 통해 mcp-server-shell 설치할 수 있습니다.

지엑스피1

설치 후 다음을 사용하여 스크립트로 실행할 수 있습니다.

python -m mcp_server_shell

구성

Claude.app에 대한 구성

Claude 설정에 추가:

"mcpServers": {
  "shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
}

"mcpServers": {
  "shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
}

Zed에 대한 구성

Zed settings.json에 다음을 추가합니다.

"context_servers": {
  "mcp-server-shell": {
    "command": "uvx",
    "args": ["mcp-server-shell"]
  }
},

"context_servers": {
  "mcp-server-shell": {
    "command": "python",
    "args": ["-m", "mcp_server_shell"]
  }
},

예시 상호작용

셸 명령을 실행합니다:

{
  "name": "execute_command",
  "arguments": {
    "command": "ls -la"
  }
}

응답:

{
  "command": "ls -la",
  "output": "total 24\ndrwxr-xr-x  5 user  group   160 Jan  1 12:00 .\ndrwxr-xr-x  3 user  group    96 Jan  1 12:00 ..",
  "return_code": 0
}

디버깅

MCP 검사기를 사용하여 서버를 디버깅할 수 있습니다. UVX 설치의 경우:

npx @modelcontextprotocol/inspector uvx mcp-server-shell

또는 특정 디렉토리에 패키지를 설치했거나 해당 디렉토리에서 개발 중인 경우:

cd path/to/servers/src/shell
npx @modelcontextprotocol/inspector uv run mcp-server-shell

클로드에 대한 질문의 예

1. "현재 디렉토리에는 어떤 파일이 있나요?"

2. "README.md 파일의 내용을 보여주세요"

3. "현재 시스템 날짜는 언제인가요?"

4. "Python이 설치되어 있는지 확인하고 버전을 표시하세요"

보안 고려 사항

⚠️ 경고 : 이 서버는 사용자 시스템에서 직접 셸 명령을 실행합니다. 무단 또는 위험한 명령 실행을 방지하기 위해 주의해서 사용하고 적절한 보안 조치를 구현하세요.

기여하다

mcp-server-shell의 확장 및 개선을 위한 여러분의 참여를 기다립니다. 새로운 기능 추가, 보안 강화, 문서 개선 등 어떤 목적이든 여러분의 의견은 소중합니다.

다른 MCP 서버 및 구현 패턴의 예는 https://github.com/modelcontextprotocol/servers를 참조하세요.

풀 리퀘스트를 환영합니다! mcp-server-shell을 더욱 강력하고 유용하게 만들기 위한 새로운 아이디어, 버그 수정, 개선 사항을 자유롭게 공유해 주세요.

특허

mcp-server-shell은 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.