[{"_1":2,"_280":-5,"_281":-5},"loaderData",{"_3":4,"_53":54,"_55":56,"_57":58,"_250":251},"root",{"_5":6,"_49":50,"_51":52},"appGlobal",{"_7":8,"_38":39,"_40":41},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":-5,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":31,"_35":31,"_36":37},"APP_URL","https://glama.ai","CLIENT_ASSETS_URL","https://static.glama.ai/client/","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","INTERCOM_APP_ID","wgcqevfz","INTERCOM_USER_HASH","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@aa9d1aa3","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51QpZQ32LV3sZcHqzHlFuNhgSfggSNaQqCzZw9EMJ8tbhpQyZgcwQj1vz168FxQ35EGRcztKu2MankxiSs7zLCF4g00blUverGs","viewportWidth",1280,"visitorSession",{"_42":43,"_45":-5,"_46":47,"_48":-5},"attributes",[44],"BOT","membership","uid","2ps1ogwU4W","userAccount","nonce","68ed5954ade3217326c502665e02dfe9","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_59":-5,"_60":61,"_169":170},"githubUser","mcpServer",{"_62":63,"_64":65,"_42":79,"_85":86,"_87":86,"_88":89,"_94":95,"_117":118,"_119":31,"_120":121,"_113":139,"_140":-5,"_141":-5,"_142":143,"_144":145,"_152":-5,"_153":154,"_159":-5,"_160":161,"_165":-5,"_46":166,"_167":168},"addedAt",["D",1741476992864],"argumentsJsonSchema",{"_66":67,"_68":69,"_70":71},"type","object","required",[],"properties",{"_72":73},"COMMAND_TIMEOUT",{"_66":74,"_75":76,"_77":78},"string","default","30","description","Max execution time in seconds for commands",[80,81,82,83,84],"category:os-automation","category:developer-tools","hosting:local-only","language:python","license_grade:a","descriptionMarkdown","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.","descriptionPlainText","githubProject",{"_90":91,"_92":93},"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

","url","https://github.com/blazickjp/shell-mcp-server","githubRepository",{"_96":97,"_98":99,"_100":101,"_102":103,"_104":105,"_109":110,"_111":112,"_115":116},"defaultBranch","main","fullName","blazickjp/shell-mcp-server","githubTreeId",73747,"language","Python","owner",{"_106":107,"_108":31},"login","blazickjp","verified","recentStargazers",1,"spdxLicense",{"_113":114},"name","Apache 2.0","stargazers",7,"id",1338,"inspectable","integrations",[122,132],{"_123":124,"_77":130,"_46":131},"brand",{"_125":126,"_113":127,"_128":129},"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",{"_123":133,"_77":137,"_46":138},{"_125":134,"_113":135,"_128":136},"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","Shell MCP Server","npmPackage","prompts","redditPostForeignId","1j6upy3","relatedMcpServerIds",[146,147,148,149,150,151],1372,679,983,724,531,543,"resources","scores",{"_155":156,"_157":-5,"_158":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms",[162,163,164],"WINDOWS","LINUX","MACOS","tools","oqel9j0pea","updatedAt",["D",1742022665616],"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":86,"_113":77},"content",{"_177":178,"_179":180,"_181":182},"href","https://glama.ai/mcp/servers/oqel9j0pea","rel","canonical","tagName","link",{"_175":139,"_184":185},"property","og:title",{"_175":86,"_184":187},"og:description",{"_175":189,"_184":190},"https://glama.ai/logo.png","og:logo",{"_175":192,"_184":193},"https://glama.ai/mcp/servers/oqel9j0pea/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},"ChatGPT alternative for power users","og:site_name",{"_175":209,"_113":210},"summary_large_image","twitter:card",{"_175":206,"_113":212},"twitter:title",{"_175":86,"_113":214},"twitter:description",{"_175":192,"_113":216},"twitter:image",{"_175":195,"_113":218},"twitter:image:height",{"_175":198,"_113":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,240,244,248],{"_230":235,"_236":237,"_113":238,"_239":110},"ListItem","item","https://glama.ai/","Glama","position",{"_230":235,"_236":241,"_113":242,"_239":243},"https://glama.ai/mcp","MCP",2,{"_230":235,"_236":245,"_113":246,"_239":247},"https://glama.ai/mcp/servers","Servers",3,{"_230":235,"_236":178,"_113":139,"_239":249},4,"routes/_public/mcp/servers/~uid/_pages/_explorer/tree/~branch/~/_route",{"_252":97,"_60":253,"_273":274,"_275":276},"branch",{"_62":254,"_64":255,"_42":259,"_85":86,"_87":86,"_88":260,"_94":261,"_117":118,"_119":31,"_120":264,"_113":139,"_140":-5,"_141":-5,"_142":143,"_144":269,"_152":-5,"_153":270,"_159":-5,"_160":271,"_165":-5,"_46":166,"_167":272},["D",1741476992864],{"_66":67,"_68":256,"_70":257},[],{"_72":258},{"_66":74,"_75":76,"_77":78},[80,81,82,83,84],{"_90":91,"_92":93},{"_96":97,"_98":99,"_100":101,"_102":103,"_104":262,"_109":110,"_111":263,"_115":116},{"_106":107,"_108":31},{"_113":114},[265,267],{"_123":266,"_77":130,"_46":131},{"_125":126,"_113":127,"_128":129},{"_123":268,"_77":137,"_46":138},{"_125":134,"_113":135,"_128":136},[146,147,148,149,150,151],{"_155":156,"_157":-5,"_158":-5},[162,163,164],["D",1742022665616],"path","src","treeMembers",[277],{"_273":278,"_66":279},"src/shell_mcp_server","tree","actionData","errors"]