A
securityF
licenseA
qualityA Model Context Protocol server that allows LLMs to interact with Python environments, execute code, and manage files within a specified working directory.
Last updated -
9
78
Shell MCP 서버
셸 명령 실행 기능을 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 LLM은 셸 명령을 실행하고 제어된 방식으로 출력을 수신할 수 있습니다.
사용 가능한 도구
execute_command- 셸 명령을 실행하고 출력을 반환합니다.필수 인수:
command(문자열): 실행할 쉘 명령
보고:
명령 결과에는 다음이 포함됩니다.
command: 실행된 명령output: stdout과 stderr 출력 결합return_code: 명령 실행 반환 코드
설치
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
클로드에 대한 질문의 예
"현재 디렉토리에는 어떤 파일이 있나요?"
"README.md 파일의 내용을 보여주세요"
"현재 시스템 날짜는 언제인가요?"
"Python이 설치되어 있는지 확인하고 버전을 표시하세요"
보안 고려 사항
⚠️ 경고 : 이 서버는 사용자 시스템에서 직접 셸 명령을 실행합니다. 무단 또는 위험한 명령 실행을 방지하기 위해 주의해서 사용하고 적절한 보안 조치를 구현하세요.
기여하다
mcp-server-shell의 확장 및 개선을 위한 여러분의 참여를 기다립니다. 새로운 기능 추가, 보안 강화, 문서 개선 등 어떤 목적이든 여러분의 의견은 소중합니다.
다른 MCP 서버 및 구현 패턴의 예는 https://github.com/modelcontextprotocol/servers를 참조하세요.
풀 리퀘스트를 환영합니다! mcp-server-shell을 더욱 강력하고 유용하게 만들기 위한 새로운 아이디어, 버그 수정, 개선 사항을 자유롭게 공유해 주세요.
특허
mcp-server-shell은 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that allows LLMs to execute shell commands with explicit user permission through desktop notifications.Last updated -2201MIT License
- AsecurityFlicenseAqualityA local Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH connections.Last updated -612
- Asecurity-licenseAqualityA Model Context Protocol server that allows LLMs to interact with Python environments, enabling code execution, file operations, package management, and development workflows.Last updated -9