Linux Bash MCP Server

# Release Notes - Linux Bash MCP Server v1.0.0 ## 🎉 Initial Release This is the initial release of Linux Bash MCP Server, a powerful Model Context Protocol server that enables Claude Desktop to execute bash commands and scripts in any WSL2 Linux distribution. ## ✨ Key Features ### 🐧 Universal Linux Distribution Support - Works with Ubuntu, Debian, Fedora, openSUSE, Alpine Linux, Kali Linux, and more - Automatic detection and configuration of available WSL distributions - No hardcoded distribution names - fully dynamic ### 🛡️ Safe Configuration Management - Preserves existing MCP servers when configuring Claude Desktop - Automatic backup creation for corrupted configurations - Intelligent merging that never overwrites existing settings ### 🔧 Comprehensive Tool Suite Six powerful tools for Linux system interaction: 1. **execute_bash_command** - Execute single bash commands with full output 2. **execute_bash_script** - Run bash scripts with arguments and working directory control 3. **create_bash_script** - Create new executable bash scripts 4. **list_directory** - List directory contents with optional detailed view 5. **get_system_info** - Get comprehensive system information (OS, memory, disk, etc.) 6. **check_wsl_status** - Check WSL2 status and distribution information ### 🚀 Developer Experience - **One-command setup**: `npm run fix` automatically configures everything - **Comprehensive diagnostics**: `npm run debug` identifies and reports issues - **Interactive setup wizard**: `npm run setup` for manual configuration - **Auto-fix utilities**: Automatic resolution of common problems - **Extensive testing**: Full test suite with cross-distribution compatibility ### 📊 Enhanced Debugging & Monitoring - Debug mode with extensive logging - Real-time command execution monitoring - Detailed error reporting and stack traces - Configuration validation and verification - WSL connection testing and health checks ## 🛠️ Installation Methods ### Quick Setup (Recommended) ```bash git clone https://github.com/yourusername/linux-bash-mcp-server.git cd linux-bash-mcp-server npm run fix ``` ### Manual Setup ```bash npm install npm run setup npm test ``` ### Diagnostic Mode ```bash npm run debug npm run check-config ``` ## 🎯 Use Cases ### System Administration - Monitor system resources and performance - Check running processes and services - Manage file systems and permissions - View system logs and configuration files ### Development & DevOps - Git repository management - Docker container operations - Package management across distributions - Environment setup and configuration ### File Operations - Browse and search file systems - Create and manage scripts - Backup and archive operations - Log analysis and monitoring ### Learning & Exploration - Learn Linux commands interactively - Explore different distribution features - Test scripts and commands safely - Practice system administration ## 🔒 Security Features - Input validation and sanitization - Command timeout protection - Secure script creation with proper escaping - Working directory isolation - Error handling without data exposure ## 📋 System Requirements - **Operating System**: Windows 10/11 with WSL2 - **Linux Distributions**: Any WSL2-compatible distribution - **Node.js**: Version 18.0.0 or higher - **Claude Desktop**: Latest version - **Memory**: 512MB+ available for Node.js processes - **Disk Space**: 50MB+ for installation ## 🌟 What's Next Future releases may include: - Web-based configuration interface - Additional Linux distribution support - Performance optimizations - Extended diagnostic capabilities - Integration with cloud Linux instances - Advanced script templates and examples ## 🤝 Contributing We welcome contributions! Please see: - [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines - [GitHub Issues](https://github.com/yourusername/linux-bash-mcp-server/issues) for bug reports - [GitHub Discussions](https://github.com/yourusername/linux-bash-mcp-server/discussions) for feature requests ## 📞 Support - **Documentation**: README.md and TROUBLESHOOTING.md - **Diagnostics**: Run `npm run debug` for automated problem detection - **Issues**: GitHub Issues for bug reports and feature requests - **Community**: GitHub Discussions for questions and ideas ## 🙏 Acknowledgments Special thanks to: - **Anthropic** for the Model Context Protocol - **Microsoft** for WSL2 technology - **The Linux community** for the amazing distributions - **Open source contributors** who make projects like this possible --- **Download**: [Linux Bash MCP Server v1.0.0](https://github.com/yourusername/linux-bash-mcp-server/releases/tag/v1.0.0) **Installation**: `git clone https://github.com/yourusername/linux-bash-mcp-server.git && cd linux-bash-mcp-server && npm run fix` Made with ❤️ for the Claude Desktop and Linux community!