[{"_1":2,"_306":-5,"_307":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_251":252},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",7058884,"membership","referenceId","01971406-43e3-74e8-b880-2f000258007a","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_68":-5,"_69":28,"_29":70,"_169":170,"_250":127},"availableLocales",[28,40,47,54,61],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","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.","name","Shell MCP Server","readme","# 🖥️ Shell MCP Server\n\n[![PyPI version](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n> 🚀 Add secure shell command execution capabilities to your AI applications with the Shell MCP Server! Built for the Model Context Protocol.\n\n## ✨ Features\n\n- 🔒 **Secure Execution** - Commands run only in specified directories\n- 🐚 **Multiple Shells** - Support for bash, sh, cmd, powershell\n- ⏱️ **Timeout Control** - Automatic termination of long-running commands\n- 🌍 **Cross-Platform** - Works on both Unix and Windows systems\n- 🛡️ **Safe by Default** - Built-in directory and shell validation\n\n## 🚀 Quick Start\n\n### Installation\n\n```bash\n# Using pip\npip install shell-mcp-server\n\n# Using uv (recommended)\nuv pip install shell-mcp-server\n```\n\n### 🔌 Claude Desktop Integration\n\nAdd this to your Claude Desktop config to enable shell command execution:\n\n

📝 Click to view configuration

\n\n```json\n{\n \"mcpServers\": {\n \"shell-mcp-server\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/shell-mcp-server\",\n \"run\",\n \"shell-mcp-server\",\n \"/path/to/allowed/dir1\",\n \"/path/to/allowed/dir2\",\n \"--shell\", \"bash\", \"/bin/bash\",\n \"--shell\", \"zsh\", \"/bin/zsh\"\n ]\n }\n }\n}\n```\n

\n\n## 🎮 Usage Examples\n\n### Basic File Operations\n```python\n# List directory contents\nresult = execute_command(\n command=\"ls -la\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# Find files by pattern\nresult = execute_command(\n command=\"find . -name '*.py'\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n```\n\n### Project Management\n```python\n# Git operations\nresult = execute_command(\n command=\"git status && git diff\",\n shell=\"bash\",\n cwd=\"/path/to/repo\"\n)\n\n# Package management\nresult = execute_command(\n command=\"pip list --outdated\",\n shell=\"bash\",\n cwd=\"/path/to/python/project\"\n)\n```\n\n### System Information\n```python\n# Resource usage\nresult = execute_command(\n command=\"df -h && free -h\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n\n# Process monitoring\nresult = execute_command(\n command=\"ps aux | grep python\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n```\n\n### File Processing\n```python\n# Search file content\nresult = execute_command(\n command=\"grep -r 'TODO' .\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# File manipulation\nresult = execute_command(\n command=\"awk '{print $1}' data.csv | sort | uniq -c\",\n shell=\"bash\",\n cwd=\"/path/to/data\"\n)\n```\n\n### Windows-Specific Examples\n```python\n# List processes\nresult = execute_command(\n command=\"Get-Process | Where-Object {$_.CPU -gt 10}\",\n shell=\"powershell\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n\n# System information\nresult = execute_command(\n command=\"systeminfo | findstr /B /C:'OS'\",\n shell=\"cmd\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n```\n\n## ⚙️ Configuration\n\nConfigure behavior with command-line arguments:\n\n| Argument | Description |\n|----------|-------------|\n| `directories` | 📁 List of allowed directories |\n| `--shell name path` | 🐚 Shell specifications (name and path) |\n\nEnvironment variables:\n- `COMMAND_TIMEOUT`: ⏱️ Max execution time in seconds (default: 30)\n\n## 🛡️ Security Features\n\n- 🔐 **Directory Isolation**: Commands can only execute in specified directories\n- 🔒 **Shell Control**: Only configured shells are allowed\n- ⏰ **Timeout Protection**: All commands have a configurable timeout\n- 🛑 **Path Validation**: Working directory validation prevents traversal attacks\n- 👤 **Permission Isolation**: Commands run with the same permissions as the server process\n\n## 🛠️ Development\n\nSet up your development environment:\n\n```bash\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate\n\n# Install development dependencies\nuv pip install -e \".[test]\"\n\n# Run tests\npython -m pytest\n\n# Run tests with coverage\npython -m pytest --cov=shell_mcp_server\n```\n\n## 🤝 Contributing\n\nContributions are welcome! Feel free to:\n\n- 🐛 Report bugs\n- 💡 Suggest features\n- 🔧 Submit pull requests\n- 📚 Improve documentation\n\n## 📜 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n---\n\n

\n\n### 🌟 Enhance Your AI with Secure Shell Access! 🌟\n\nBuilt for the [Model Context Protocol](https://github.com/anthropics/anthropic-tools) | Made with ❤️ by the MCP Community\n\n

🎉 Star us on GitHub!

\n
\nIf you find this tool useful, consider giving it a star! It helps others discover the project.\n

\n\n

","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Un servidor seguro que permite que las aplicaciones de IA ejecuten comandos de shell en directorios específicos, admitiendo múltiples tipos de shell (bash, sh, cmd, powershell) con funciones de seguridad integradas como aislamiento de directorio y control de tiempo de espera.","Servidor MCP de Shell","# 🖥️ Servidor Shell MCP\n\n[![Versión de PyPI](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server) [![Licencia: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Pitón](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![Estilo de código: negro](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n> 🚀 ¡Añade funciones de ejecución de comandos de shell seguro a tus aplicaciones de IA con el Servidor Shell MCP! Diseñado para el Protocolo de Contexto de Modelo.\n\n## ✨ Características\n\n* 🔒 **Ejecución segura** : los comandos se ejecutan solo en directorios específicos\n* 🐚 **Múltiples shells** : compatibilidad con bash, sh, cmd y powershell\n* ⏱️ **Control de tiempo de espera** : finalización automática de comandos de larga duración\n* 🌍 **Multiplataforma** : funciona en sistemas Unix y Windows\n* 🛡️ **Seguro por defecto** : validación de directorio y shell integrada\n\n## 🚀 Inicio rápido\n\n### Instalación\n\n```bash\n# Using pip\npip install shell-mcp-server\n\n# Using uv (recommended)\nuv pip install shell-mcp-server\n```\n\n### 🔌 Integración de escritorio de Claude\n\nAgregue esto a su configuración de Claude Desktop para habilitar la ejecución de comandos de shell:\n\n```json\n{\n \"mcpServers\": {\n \"shell-mcp-server\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/shell-mcp-server\",\n \"run\",\n \"shell-mcp-server\",\n \"/path/to/allowed/dir1\",\n \"/path/to/allowed/dir2\",\n \"--shell\", \"bash\", \"/bin/bash\",\n \"--shell\", \"zsh\", \"/bin/zsh\"\n ]\n }\n }\n}\n```\n\n## Ejemplos de uso\n\n### Operaciones básicas con archivos\n\n```python\n# List directory contents\nresult = execute_command(\n command=\"ls -la\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# Find files by pattern\nresult = execute_command(\n command=\"find . -name '*.py'\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n```\n\n### Gestión de proyectos\n\n```python\n# Git operations\nresult = execute_command(\n command=\"git status && git diff\",\n shell=\"bash\",\n cwd=\"/path/to/repo\"\n)\n\n# Package management\nresult = execute_command(\n command=\"pip list --outdated\",\n shell=\"bash\",\n cwd=\"/path/to/python/project\"\n)\n```\n\n### Información del sistema\n\n```python\n# Resource usage\nresult = execute_command(\n command=\"df -h && free -h\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n\n# Process monitoring\nresult = execute_command(\n command=\"ps aux | grep python\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n```\n\n### Procesamiento de archivos\n\n```python\n# Search file content\nresult = execute_command(\n command=\"grep -r 'TODO' .\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# File manipulation\nresult = execute_command(\n command=\"awk '{print $1}' data.csv | sort | uniq -c\",\n shell=\"bash\",\n cwd=\"/path/to/data\"\n)\n```\n\n### Ejemplos específicos de Windows\n\n```python\n# List processes\nresult = execute_command(\n command=\"Get-Process | Where-Object {$_.CPU -gt 10}\",\n shell=\"powershell\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n\n# System information\nresult = execute_command(\n command=\"systeminfo | findstr /B /C:'OS'\",\n shell=\"cmd\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n```\n\n## ⚙️ Configuración\n\nConfigurar el comportamiento con argumentos de la línea de comandos:\n\n| Argumento | Descripción |\n| ------------------- | --------------------------------------------- |\n| `directories` | 📁 Lista de directorios permitidos |\n| `--shell name path` | 🐚 Especificaciones del shell (nombre y ruta) |\n\nVariables de entorno:\n\n* `COMMAND_TIMEOUT` : ⏱️ Tiempo máximo de ejecución en segundos (predeterminado: 30)\n\n## 🛡️ Funciones de seguridad\n\n* 🔐 **Aislamiento de directorio** : los comandos solo se pueden ejecutar en directorios específicos\n* 🔒 **Control de shell** : solo se permiten shells configurados\n* ⏰ **Protección de tiempo de espera** : todos los comandos tienen un tiempo de espera configurable\n* 🛑 **Validación de ruta** : La validación del directorio de trabajo evita ataques transversales\n* 👤 **Aislamiento de permisos** : los comandos se ejecutan con los mismos permisos que el proceso del servidor\n\n## 🛠️ Desarrollo\n\nConfigure su entorno de desarrollo:\n\n```bash\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate\n\n# Install development dependencies\nuv pip install -e \".[test]\"\n\n# Run tests\npython -m pytest\n\n# Run tests with coverage\npython -m pytest --cov=shell_mcp_server\n```\n\n## 🤝 Contribuyendo\n\n¡Agradecemos sus contribuciones! Siéntase libre de:\n\n* 🐛 Informar errores\n* 💡 Sugerir características\n* 🔧 Enviar solicitudes de extracción\n* 📚 Mejorar la documentación\n\n## 📜 Licencia\n\nLicencia MIT: consulte [LICENCIA](LICENSE) para obtener más detalles.\n\n***\n\n### 🌟 ¡Mejora tu IA con acceso seguro a Shell! 🌟\n\nCreado para el [Protocolo de Contexto del Modelo](https://github.com/anthropics/anthropic-tools) | Hecho con ❤️ por la Comunidad MCP","Spanish","es-ES",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"AI アプリケーションが指定されたディレクトリでシェルコマンドを実行できるようにする安全なサーバーです。ディレクトリ分離やタイムアウト制御などのセキュリティ機能が組み込まれており、複数のシェルタイプ (bash、sh、cmd、powershell) をサポートします。","シェルMCPサーバー","# 🖥️ シェル MCP サーバー\n\n[![PyPIバージョン](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server) [![ライセンス: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![パイソン](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![コードスタイル: 黒](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n> 🚀 Shell MCP サーバーを使用して、AI アプリケーションに安全なシェルコマンド実行機能を追加します。モデルコンテキストプロトコル用に構築されています。\n\n## ✨ 特徴\n\n* 🔒**セキュア実行**- コマンドは指定されたディレクトリ内でのみ実行されます\n* 🐚**複数のシェル**- bash、sh、cmd、powershell をサポート\n* ⏱️**タイムアウト制御**- 長時間実行されるコマンドの自動終了\n* 🌍**クロスプラットフォーム**- Unix と Windows の両方のシステムで動作します\n* 🛡️**デフォルトで安全**- ディレクトリとシェルの検証が組み込まれています\n\n## 🚀 クイックスタート\n\n### インストール\n\n```bash\n# Using pip\npip install shell-mcp-server\n\n# Using uv (recommended)\nuv pip install shell-mcp-server\n```\n\n### 🔌 クロードデスクトップ統合\n\nシェルコマンドの実行を有効にするには、Claude Desktop 構成にこれを追加します。\n\n```json\n{\n \"mcpServers\": {\n \"shell-mcp-server\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/shell-mcp-server\",\n \"run\",\n \"shell-mcp-server\",\n \"/path/to/allowed/dir1\",\n \"/path/to/allowed/dir2\",\n \"--shell\", \"bash\", \"/bin/bash\",\n \"--shell\", \"zsh\", \"/bin/zsh\"\n ]\n }\n }\n}\n```\n\n## 🎮 使用例\n\n### 基本的なファイル操作\n\n```python\n# List directory contents\nresult = execute_command(\n command=\"ls -la\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# Find files by pattern\nresult = execute_command(\n command=\"find . -name '*.py'\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n```\n\n### プロジェクト管理\n\n```python\n# Git operations\nresult = execute_command(\n command=\"git status && git diff\",\n shell=\"bash\",\n cwd=\"/path/to/repo\"\n)\n\n# Package management\nresult = execute_command(\n command=\"pip list --outdated\",\n shell=\"bash\",\n cwd=\"/path/to/python/project\"\n)\n```\n\n### システム情報\n\n```python\n# Resource usage\nresult = execute_command(\n command=\"df -h && free -h\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n\n# Process monitoring\nresult = execute_command(\n command=\"ps aux | grep python\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n```\n\n### ファイル処理\n\n```python\n# Search file content\nresult = execute_command(\n command=\"grep -r 'TODO' .\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# File manipulation\nresult = execute_command(\n command=\"awk '{print $1}' data.csv | sort | uniq -c\",\n shell=\"bash\",\n cwd=\"/path/to/data\"\n)\n```\n\n### Windows固有の例\n\n```python\n# List processes\nresult = execute_command(\n command=\"Get-Process | Where-Object {$_.CPU -gt 10}\",\n shell=\"powershell\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n\n# System information\nresult = execute_command(\n command=\"systeminfo | findstr /B /C:'OS'\",\n shell=\"cmd\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n```\n\n## ⚙️ 構成\n\nコマンドライン引数を使用して動作を構成します。\n\n| 口論 | 説明 |\n| ------------------- | ------------------ |\n| `directories` | 📁 許可されたディレクトリのリスト |\n| `--shell name path` | 🐚 シェルの仕様（名前とパス） |\n\n環境変数:\n\n* `COMMAND_TIMEOUT` : ⏱️ 最大実行時間（秒）（デフォルト: 30）\n\n## 🛡️ セキュリティ機能\n\n* 🔐**ディレクトリ分離**: コマンドは指定されたディレクトリ内でのみ実行できます\n* 🔒**シェル制御**: 設定されたシェルのみが許可されます\n* ⏰**タイムアウト保護**: すべてのコマンドには設定可能なタイムアウトがあります\n* 🛑**パス検証**: 作業ディレクトリの検証によりトラバーサル攻撃を防止\n* 👤**権限分離**: コマンドはサーバープロセスと同じ権限で実行されます\n\n## 🛠️ 開発\n\n開発環境をセットアップします。\n\n```bash\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate\n\n# Install development dependencies\nuv pip install -e \".[test]\"\n\n# Run tests\npython -m pytest\n\n# Run tests with coverage\npython -m pytest --cov=shell_mcp_server\n```\n\n## 🤝 貢献する\n\n貢献大歓迎！お気軽にどうぞ：\n\n* 🐛 バグを報告する\n* 💡 機能を提案する\n* 🔧 プルリクエストを送信する\n* 📚 ドキュメントの改善\n\n## 📜 ライセンス\n\nMIT ライセンス - 詳細については[ライセンスを](LICENSE)参照してください。\n\n***\n\n### 🌟 セキュアシェルアクセスで AI を強化しましょう! 🌟\n\n[モデルコンテキストプロトコル](https://github.com/anthropics/anthropic-tools)向けに構築 | MCPコミュニティによって愛を込めて作成","Japanese","ja-JP",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"AI 애플리케이션이 지정된 디렉토리에서 셸 명령을 실행할 수 있도록 하는 보안 서버로, 디렉토리 격리 및 시간 초과 제어와 같은 내장 보안 기능이 있는 여러 셸 유형(bash, sh, cmd, powershell)을 지원합니다.","Shell MCP 서버","# 🖥️ 셸 MCP 서버\n\n[![PyPI 버전](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server) [![라이센스: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![파이썬](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![코드 스타일: 검정색](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n> 🚀 Shell MCP 서버를 사용하여 AI 애플리케이션에 보안 셸 명령 실행 기능을 추가하세요! 모델 컨텍스트 프로토콜(MCP)을 위해 설계되었습니다.\n\n## ✨ 특징\n\n* 🔒 **안전한 실행** - 명령은 지정된 디렉토리에서만 실행됩니다.\n* 🐚 **다중 셸** - bash, sh, cmd, powershell 지원\n* ⏱️ **시간 초과 제어** - 장기 실행 명령의 자동 종료\n* 🌍 **크로스 플랫폼** - Unix 및 Windows 시스템 모두에서 작동합니다.\n* 🛡️ **기본적으로 안전함** - 내장된 디렉토리 및 셸 검증\n\n## 🚀 빠른 시작\n\n### 설치\n\n지엑스피1\n\n### 🔌 Claude 데스크톱 통합\n\n셸 명령 실행을 활성화하려면 Claude Desktop 구성에 다음을 추가하세요.\n\n```json\n{\n \"mcpServers\": {\n \"shell-mcp-server\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/shell-mcp-server\",\n \"run\",\n \"shell-mcp-server\",\n \"/path/to/allowed/dir1\",\n \"/path/to/allowed/dir2\",\n \"--shell\", \"bash\", \"/bin/bash\",\n \"--shell\", \"zsh\", \"/bin/zsh\"\n ]\n }\n }\n}\n```\n\n## 🎮 사용 예시\n\n### 기본 파일 작업\n\n```python\n# List directory contents\nresult = execute_command(\n command=\"ls -la\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# Find files by pattern\nresult = execute_command(\n command=\"find . -name '*.py'\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n```\n\n### 프로젝트 관리\n\n```python\n# Git operations\nresult = execute_command(\n command=\"git status && git diff\",\n shell=\"bash\",\n cwd=\"/path/to/repo\"\n)\n\n# Package management\nresult = execute_command(\n command=\"pip list --outdated\",\n shell=\"bash\",\n cwd=\"/path/to/python/project\"\n)\n```\n\n### 시스템 정보\n\n```python\n# Resource usage\nresult = execute_command(\n command=\"df -h && free -h\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n\n# Process monitoring\nresult = execute_command(\n command=\"ps aux | grep python\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n```\n\n### 파일 처리\n\n```python\n# Search file content\nresult = execute_command(\n command=\"grep -r 'TODO' .\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# File manipulation\nresult = execute_command(\n command=\"awk '{print $1}' data.csv | sort | uniq -c\",\n shell=\"bash\",\n cwd=\"/path/to/data\"\n)\n```\n\n### Windows 관련 예제\n\n```python\n# List processes\nresult = execute_command(\n command=\"Get-Process | Where-Object {$_.CPU -gt 10}\",\n shell=\"powershell\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n\n# System information\nresult = execute_command(\n command=\"systeminfo | findstr /B /C:'OS'\",\n shell=\"cmd\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n```\n\n## ⚙️ 구성\n\n명령줄 인수를 사용하여 동작을 구성합니다.\n\n| 논쟁 | 설명 |\n| ------------------- | ---------------- |\n| `directories` | 📁 허용된 디렉토리 목록 |\n| `--shell name path` | 🐚 셸 사양(이름 및 경로) |\n\n환경 변수:\n\n* `COMMAND_TIMEOUT` : ⏱️ 최대 실행 시간(초) (기본값: 30)\n\n## 🛡️ 보안 기능\n\n* 🔐 **디렉토리 격리** : 명령은 지정된 디렉토리에서만 실행될 수 있습니다.\n* 🔒 **셸 제어** : 구성된 셸만 허용됩니다.\n* ⏰ **시간 초과 보호** : 모든 명령에는 구성 가능한 시간 초과가 있습니다.\n* 🛑 **경로 검증** : 작업 디렉터리 검증은 트래버설 공격을 방지합니다.\n* 👤 **권한 격리** : 명령은 서버 프로세스와 동일한 권한으로 실행됩니다.\n\n## 🛠️ 개발\n\n개발 환경을 설정하세요.\n\n```bash\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate\n\n# Install development dependencies\nuv pip install -e \".[test]\"\n\n# Run tests\npython -m pytest\n\n# Run tests with coverage\npython -m pytest --cov=shell_mcp_server\n```\n\n## 🤝 기여하기\n\n여러분의 참여를 환영합니다! 자유롭게 참여해 주세요:\n\n* 🐛 버그 신고\n* 💡 기능 제안\n* 🔧 풀 리퀘스트 제출\n* 📚 문서 개선\n\n## 📜 라이센스\n\nMIT 라이센스 - 자세한 내용은 [라이센스를](LICENSE) 참조하세요.\n\n***\n\n### 🌟 Secure Shell Access로 AI를 강화하세요! 🌟\n\n[모델 컨텍스트 프로토콜](https://github.com/anthropics/anthropic-tools) 용으로 제작 | MCP 커뮤니티에서 ❤️로 제작","Korean","ko-KR",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"一个安全的服务器，使AI应用程序能够在指定的目录中执行shell命令，支持多种shell类型（bash，sh，cmd，powershell），并具有目录隔离和超时控制等内置安全功能。","Shell MCP 服务器","# 🖥️ Shell MCP 服务器\n\n[![PyPI 版本](https://badge.fury.io/py/shell-mcp-server.svg)](https://badge.fury.io/py/shell-mcp-server) [![许可证：MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [![代码样式：黑色](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n> 🚀 使用 Shell MCP 服务器为您的 AI 应用程序添加安全的 Shell 命令执行功能！专为模型上下文协议构建。\n\n## ✨ 特点\n\n* 🔒**安全执行**- 命令仅在指定目录中运行\n* 🐚**多 Shell** - 支持 bash、sh、cmd、powershell\n* ⏱️**超时控制**- 自动终止长时间运行的命令\n* 🌍**跨平台**- 适用于 Unix 和 Windows 系统\n* 🛡️**默认安全**- 内置目录和 shell 验证\n\n## 🚀 快速入门\n\n### 安装\n\n```bash\n# Using pip\npip install shell-mcp-server\n\n# Using uv (recommended)\nuv pip install shell-mcp-server\n```\n\n### 🔌 Claude 桌面集成\n\n将其添加到您的 Claude Desktop 配置以启用 shell 命令执行：\n\n```json\n{\n \"mcpServers\": {\n \"shell-mcp-server\": {\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"/path/to/shell-mcp-server\",\n \"run\",\n \"shell-mcp-server\",\n \"/path/to/allowed/dir1\",\n \"/path/to/allowed/dir2\",\n \"--shell\", \"bash\", \"/bin/bash\",\n \"--shell\", \"zsh\", \"/bin/zsh\"\n ]\n }\n }\n}\n```\n\n## 🎮 使用示例\n\n### 基本文件操作\n\n```python\n# List directory contents\nresult = execute_command(\n command=\"ls -la\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# Find files by pattern\nresult = execute_command(\n command=\"find . -name '*.py'\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n```\n\n### 项目管理\n\n```python\n# Git operations\nresult = execute_command(\n command=\"git status && git diff\",\n shell=\"bash\",\n cwd=\"/path/to/repo\"\n)\n\n# Package management\nresult = execute_command(\n command=\"pip list --outdated\",\n shell=\"bash\",\n cwd=\"/path/to/python/project\"\n)\n```\n\n### 系统信息\n\n```python\n# Resource usage\nresult = execute_command(\n command=\"df -h && free -h\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n\n# Process monitoring\nresult = execute_command(\n command=\"ps aux | grep python\",\n shell=\"bash\",\n cwd=\"/path/to/dir\"\n)\n```\n\n### 文件处理\n\n```python\n# Search file content\nresult = execute_command(\n command=\"grep -r 'TODO' .\",\n shell=\"bash\",\n cwd=\"/path/to/project\"\n)\n\n# File manipulation\nresult = execute_command(\n command=\"awk '{print $1}' data.csv | sort | uniq -c\",\n shell=\"bash\",\n cwd=\"/path/to/data\"\n)\n```\n\n### Windows 特定示例\n\n```python\n# List processes\nresult = execute_command(\n command=\"Get-Process | Where-Object {$_.CPU -gt 10}\",\n shell=\"powershell\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n\n# System information\nresult = execute_command(\n command=\"systeminfo | findstr /B /C:'OS'\",\n shell=\"cmd\",\n cwd=\"C:\\\\path\\\\to\\\\dir\"\n)\n```\n\n## ⚙️ 配置\n\n使用命令行参数配置行为：\n\n| 争论 | 描述 |\n| ------------------- | ------------------ |\n| `directories` | 📁 允许目录列表 |\n| `--shell name path` | 🐚 Shell 规范（名称和路径） |\n\n环境变量：\n\n* `COMMAND_TIMEOUT` ：⏱️ 最大执行时间（秒）（默认值：30）\n\n## 🛡️ 安全功能\n\n* 🔐**目录隔离**：命令只能在指定目录中执行\n* 🔒 **Shell 控制**：仅允许配置的 Shell\n* ⏰**超时保护**：所有命令都有可配置的超时\n* 🛑**路径验证**：工作目录验证可防止遍历攻击\n* 👤**权限隔离**：命令以与服务器进程相同的权限运行\n\n## 🛠️ 开发\n\n设置您的开发环境：\n\n```bash\n# Create and activate virtual environment\nuv venv\nsource .venv/bin/activate\n\n# Install development dependencies\nuv pip install -e \".[test]\"\n\n# Run tests\npython -m pytest\n\n# Run tests with coverage\npython -m pytest --cov=shell_mcp_server\n```\n\n## 🤝 贡献\n\n欢迎贡献！请随意：\n\n* 🐛 报告错误\n* 💡 建议功能\n* 🔧 提交拉取请求\n* 📚 改进文档\n\n## 📜 许可证\n\nMIT 许可证 - 详情请参阅[许可证](LICENSE)。\n\n***\n\n### 🌟 使用安全 Shell 访问增强你的 AI！🌟\n\n为[模型上下文协议](https://github.com/anthropics/anthropic-tools)构建 | 由 MCP 社区倾情打造","Chinese","zh-CN","githubUser","locale",{"_71":72,"_73":74,"_13":87,"_94":32,"_95":32,"_96":97,"_100":101,"_124":-5,"_16":125,"_126":127,"_128":129,"_33":34,"_147":114,"_148":-5,"_149":-5,"_150":151,"_152":-5,"_153":154,"_159":-5,"_136":110,"_160":161,"_165":-5,"_115":166,"_167":168},"addedAt","2025-03-08T23:36:32.864864466Z","argumentsJsonSchema",{"_75":76,"_84":85,"_82":86},"properties",{"_77":78},"COMMAND_TIMEOUT",{"_79":80,"_31":81,"_82":83},"default","30","Max execution time in seconds for commands","type","string","required",[],"object",[88,89,90,91,92,93],"category:shell-access","category:os-automation","environment:local","hosting:hybrid","language:python","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":36,"_98":99},"url","https://github.com/blazickjp/shell-mcp-server","githubRepository",{"_102":103,"_104":105,"_106":107,"_108":109,"_33":110,"_111":112,"_117":118,"_119":120,"_122":123},"defaultBranch","main","fullName","blazickjp/shell-mcp-server","githubTreeId",73747,"language","Python","shell-mcp-server","owner",{"_113":114,"_115":116},"login","blazickjp","uid","et86lw2hxa","recentStargazers",2,"spdxLicense",{"_33":121},"Apache 2.0","stargazers",9,"glamaJson",1338,"inspectable",false,"integrations",[130,140],{"_131":132,"_31":138,"_115":139},"brand",{"_133":134,"_33":135,"_136":137},"logoSvgPath","M23.546 10.93L13.067.452c-.604-.603-1.582-.603-2.188 0L8.708 2.627l2.76 2.76c.645-.215 1.379-.07 1.889.441.516.515.658 1.258.438 1.9l2.658 2.66c.645-.223 1.387-.078 1.9.435.721.72.721 1.884 0 2.604-.719.719-1.881.719-2.6 0-.539-.541-.674-1.337-.404-1.996L12.86 8.955v6.525c.176.086.342.203.488.348.713.721.713 1.883 0 2.6-.719.721-1.889.721-2.609 0-.719-.719-.719-1.879 0-2.598.182-.18.387-.316.605-.406V8.835c-.217-.091-.424-.222-.6-.401-.545-.545-.676-1.342-.396-2.009L7.636 3.7.45 10.881c-.6.605-.6 1.584 0 2.189l10.48 10.477c.604.604 1.582.604 2.186 0l10.43-10.43c.605-.603.605-1.582 0-2.187","Git","slug","git","Allows execution of git commands for repository management, including viewing repository status and differences between commits.","de4vb24dvy",{"_131":141,"_31":145,"_115":146},{"_133":142,"_33":143,"_136":144},"M12 .863C5.34.863 0 6.251 0 12.98c0 .996.038 1.374.246 2.33l3.662 2.71.57 4.515h6.102l.326.227c.377.262.705.375 1.082.375.352 0 .732-.101 1.024-.313l.39-.289h6.094l.563-4.515 3.695-2.71c.208-.956.246-1.334.246-2.33C24 6.252 18.661.863 12 .863zm.996 2.258c.9 0 1.778.224 2.512.649l-2.465 12.548 3.42-12.062c1.059.36 1.863.941 2.508 1.814l.025.034-4.902 10.615 5.572-9.713.033.03c.758.708 1.247 1.567 1.492 2.648l-6.195 7.666 6.436-6.5.01.021c.253.563.417 1.36.417 1.996 0 .509-.024.712-.164 1.25l-3.554 2.602-.467 3.71h-4.475l-.517.395c-.199.158-.482.266-.682.266-.199 0-.483-.108-.682-.266l-.517-.394H6.322l-.445-3.61-3.627-2.666c-.11-.436-.16-.83-.16-1.261 0-.72.159-1.49.426-2.053l.013-.024 6.45 6.551L2.75 9.621c.25-1.063.874-2.09 1.64-2.713l5.542 9.776L4.979 6.1c.555-.814 1.45-1.455 2.546-1.827l3.424 12.069L8.355 3.816l.055-.03c.814-.45 1.598-.657 2.457-.657.195 0 .286.004.528.03l.587 13.05.46-13.059c.224-.025.309-.029.554-.029z","Shell","shell","Enables secure execution of shell commands in specified directories with support for multiple shell types, timeout control, and built-in security features to safely run system commands for file operations, git commands, package management, and system monitoring.","9avl8c9t4l","namespace","npmPackage","prompts","redditPostForeignId","1j6upy3","resources","scores",{"_155":156,"_157":-5,"_158":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[162,163,164],"WINDOWS","LINUX","MACOS","tools","oqel9j0pea","updatedAt","2025-03-20T17:26:42.435435500Z","meta",[171,174,176,183,186,188,191,194,197,200,203,205,208,211,213,215,217,219,221],{"_172":173},"title","Shell MCP Server | Glama",{"_175":32,"_33":31},"content",{"_177":178,"_179":180,"_181":182},"href","https://glama.ai/mcp/servers/@blazickjp/shell-mcp-server","rel","canonical","tagName","link",{"_175":34,"_184":185},"property","og:title",{"_175":32,"_184":187},"og:description",{"_175":189,"_184":190},"https://glama.ai/logo.png","og:logo",{"_175":192,"_184":193},"https://glama.ai/mcp/servers/@blazickjp/shell-mcp-server/og-image","og:image",{"_175":195,"_184":196},"630","og:image:height",{"_175":198,"_184":199},"1200","og:image:width",{"_175":201,"_184":202},"website","og:type",{"_175":178,"_184":204},"og:url",{"_175":206,"_184":207},"Glama – MCP Hosting Platform","og:site_name",{"_175":209,"_33":210},"summary_large_image","twitter:card",{"_175":206,"_33":212},"twitter:title",{"_175":32,"_33":214},"twitter:description",{"_175":192,"_33":216},"twitter:image",{"_175":195,"_33":218},"twitter:image:height",{"_175":198,"_33":220},"twitter:image:width",{"_222":223},"script:ld+json",{"_224":225,"_226":227},"@context","http://schema.org","@graph",[228],{"_224":229,"_230":231,"_232":233},"https://schema.org","@type","BreadcrumbList","itemListElement",[234,241,244,248],{"_230":235,"_236":237,"_33":238,"_239":240},"ListItem","item","https://glama.ai/","Glama","position",1,{"_230":235,"_236":242,"_33":243,"_239":118},"https://glama.ai/mcp","MCP",{"_230":235,"_236":245,"_33":246,"_239":247},"https://glama.ai/mcp/servers","Servers",3,{"_230":235,"_236":178,"_33":34,"_239":249},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_68":-5,"_29":253,"_169":270,"_305":-5},{"_71":72,"_73":254,"_13":258,"_94":32,"_95":32,"_96":259,"_100":260,"_124":-5,"_16":125,"_126":127,"_128":263,"_33":34,"_147":114,"_148":-5,"_149":-5,"_150":151,"_152":-5,"_153":268,"_159":-5,"_136":110,"_160":269,"_165":-5,"_115":166,"_167":168},{"_75":255,"_84":257,"_82":86},{"_77":256},{"_79":80,"_31":81,"_82":83},[],[88,89,90,91,92,93],{"_35":36,"_98":99},{"_102":103,"_104":105,"_106":107,"_108":109,"_33":110,"_111":261,"_117":118,"_119":262,"_122":123},{"_113":114,"_115":116},{"_33":121},[264,266],{"_131":265,"_31":138,"_115":139},{"_133":134,"_33":135,"_136":137},{"_131":267,"_31":145,"_115":146},{"_133":142,"_33":143,"_136":144},{"_155":156,"_157":-5,"_158":-5},[162,163,164],[271,273,275,277,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293],{"_172":272},"Reviews | Shell MCP Server | Glama",{"_175":274,"_33":31},"Read community reviews and feedback for Shell MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_177":276,"_179":180,"_181":182},"https://glama.ai/mcp/servers/@blazickjp/shell-mcp-server/reviews",{"_175":278,"_184":185},"Reviews | Shell MCP Server",{"_175":274,"_184":187},{"_175":189,"_184":190},{"_175":192,"_184":193},{"_175":195,"_184":196},{"_175":198,"_184":199},{"_175":201,"_184":202},{"_175":276,"_184":204},{"_175":206,"_184":207},{"_175":209,"_33":210},{"_175":206,"_33":212},{"_175":274,"_33":214},{"_175":192,"_33":216},{"_175":195,"_33":218},{"_175":198,"_33":220},{"_222":294},{"_224":225,"_226":295},[296],{"_224":229,"_230":231,"_232":297},[298,299,300,301,302],{"_230":235,"_236":237,"_33":238,"_239":240},{"_230":235,"_236":242,"_33":243,"_239":118},{"_230":235,"_236":245,"_33":246,"_239":247},{"_230":235,"_236":178,"_33":34,"_239":249},{"_230":235,"_236":276,"_33":303,"_239":304},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API