MCP Workspace Server

# 🏆 ULTIMATE MCP WORKSPACE SERVER ## The Most Comprehensive MCP Server for Claude Desktop **33 Professional Tools | 10+ Categories | Enterprise-Grade Capabilities** --- ## 🎯 What Makes This ULTIMATE? This isn't just an MCP server - it's a **complete development environment** accessible through natural language. With 33 carefully crafted tools spanning every aspect of software development, system administration, and content management, you can accomplish virtually any task without leaving Claude Desktop. --- ## 📊 Complete Tool Arsenal (33 Tools) ### 📁 Core File Operations (7 Tools) Essential file system operations with security sandboxing: - **list_files** - List directory contents with filtering - **read_file** - Read file contents with encoding support - **write_file** - Create or update files atomically - **delete_file** - Delete files or directories safely - **create_folder** - Create directories with parents - **apply_patch** - Apply unified diff patches - **run_command** - Execute shell commands securely ### 🔍 Advanced File Operations (5 Tools) Power user file management capabilities: - **search_files** - Grep-like text search across files - **find_files** - Find files by name, pattern, size, date - **copy_file** - Copy files and directories recursively - **move_file** - Move or rename files and folders - **get_file_info** - Detailed file metadata and checksums ### 📦 Archive & Compression (2 Tools) Complete archive management: - **compress_files** - Create ZIP/TAR/GZ archives - **extract_archive** - Extract compressed archives ### 🌐 Network Operations (1 Tool) Full-featured HTTP client: - **http_request** - Make HTTP requests with all methods, headers, timeouts ### 🔧 Git Operations (4 Tools) Complete version control workflow: - **git_status** - Repository status and changes - **git_diff** - Show differences between commits/branches - **git_log** - View commit history with filters - **git_branch** - Branch management and information ### 💻 System Operations (3 Tools) System monitoring and process management: - **system_info** - CPU, memory, disk, network information - **list_processes** - Show running processes with details - **kill_process** - Terminate processes by PID or name ### 🗄️ Database Operations (1 Tool) SQLite database management: - **database_query** - Execute SQL queries (SELECT, INSERT, UPDATE, DELETE) ### 🖼️ Image Processing (1 Tool) Image manipulation capabilities: - **image_process** - Resize, crop, rotate, format conversion, get info ### 📄 PDF Manipulation (1 Tool) PDF document handling: - **pdf_manipulate** - Extract text, get info, merge, split PDFs ### 🔐 Encryption & Security (1 Tool) File security and cryptography: - **encrypt_decrypt** - AES-256 encryption, hashing (SHA-256/512, MD5), key generation ### ⏰ Task Scheduling (1 Tool) Automated task execution: - **schedule_task** - Create, list, delete, run scheduled tasks (cron/Windows Task Scheduler) ### 📢 Notifications (1 Tool) Multi-channel alerting: - **send_notification** - System notifications, webhooks, email alerts ### 📝 Text Processing (1 Tool) Advanced text manipulation: - **text_process** - Analyze, transform, extract patterns, compare, generate text --- ## 🚀 Real-World Use Cases ### For Developers ``` ✅ Search entire codebase for patterns ✅ Manage git workflow (status, diff, log, branches) ✅ Test APIs and webhooks ✅ Automate build and deployment tasks ✅ Monitor system resources during development ✅ Compress and archive releases ✅ Apply patches and manage code changes ``` ### For System Administrators ``` ✅ Monitor system health (CPU, memory, disk) ✅ Manage running processes ✅ Schedule automated maintenance tasks ✅ Send alerts and notifications ✅ Backup and archive important files ✅ Execute system commands securely ✅ Query system databases ``` ### For Content Creators ``` ✅ Process and resize images in bulk ✅ Extract text from PDF documents ✅ Analyze text statistics and readability ✅ Transform text formats and encodings ✅ Generate secure passwords and UUIDs ✅ Compare document versions ✅ Encrypt sensitive files ``` ### For Data Analysts ``` ✅ Query SQLite databases ✅ Extract patterns from text (emails, URLs, dates) ✅ Analyze text statistics ✅ Compare datasets ✅ Generate hashes for data integrity ✅ Automate data processing tasks ✅ Send notifications when jobs complete ``` --- ## 💡 Example Commands ### Development Workflow ``` "Search for all TODO comments in TypeScript files" "Show git status and list all modified files" "Make a POST request to the API with this JSON data" "Create a ZIP archive of the src folder" "Apply this patch to fix the bug" ``` ### System Administration ``` "Show system information including CPU and memory usage" "List all processes using more than 100MB of memory" "Schedule a daily backup at 2 AM" "Send a notification when the deployment completes" "Kill the process using port 3000" ``` ### Content & Data Processing ``` "Resize all images in this folder to 800x600" "Extract text from this PDF and save to a file" "Analyze this document and show word count statistics" "Encrypt this file with AES-256 using this password" "Query the database for all users created this month" ``` ### Text Manipulation ``` "Extract all email addresses from this file" "Convert this text to camelCase format" "Generate 10 secure passwords of 16 characters" "Compare these two documents and show differences" "Generate a SHA-256 hash of this file" ``` --- ## 🔒 Security Features All tools maintain enterprise-grade security: ✅ **Workspace Sandboxing** - All operations restricted to workspace directory ✅ **Path Validation** - Prevents directory traversal attacks ✅ **Command Filtering** - Only allowed commands can be executed ✅ **Read-Only Mode** - Optional write protection ✅ **Comprehensive Logging** - All actions logged for audit ✅ **Error Handling** - Safe failure modes prevent data loss ✅ **Input Validation** - All inputs sanitized and validated --- ## 📦 Installation ### Quick Install (Recommended) 1. Download the installer 2. Double-click `install-claude-mcp-complete.bat` 3. Follow the prompts 4. Restart Claude Desktop ### Manual Install 1. Clone or download this repository 2. Run `npm install` 3. Run `npm run build` 4. Configure Claude Desktop to point to `dist/index.js` --- ## ⚙️ Configuration The server is configured via environment variables or command-line arguments: ```bash # Workspace root directory WORKSPACE_ROOT=/path/to/workspace # Read-only mode (optional) READ_ONLY=false # Log level (optional) LOG_LEVEL=info # Allowed commands (optional, comma-separated) ALLOWED_COMMANDS=npm,git,node ``` --- ## 🎓 Documentation Each tool has comprehensive documentation including: - Input parameters and types - Return values and formats - Usage examples - Error handling - Security considerations Access documentation through Claude Desktop by asking: ``` "What can the [tool_name] tool do?" "Show me examples of using [tool_name]" ``` --- ## 🏗️ Architecture Built with: - **TypeScript** - Type-safe implementation - **MCP SDK** - Official Model Context Protocol - **Node.js** - Cross-platform runtime - **Vitest** - Comprehensive testing - **Fast-Check** - Property-based testing --- ## 📈 Performance - **Fast**: Optimized for quick response times - **Reliable**: Comprehensive error handling - **Scalable**: Handles large files and directories - **Efficient**: Minimal memory footprint - **Tested**: Property-based and unit tests --- ## 🤝 Contributing Contributions welcome! This is the ULTIMATE MCP server, but there's always room for improvement: - Add new tools - Improve existing tools - Enhance documentation - Report bugs - Suggest features --- ## 📄 License MIT License - Use freely in personal and commercial projects --- ## 🌟 Why This is ULTIMATE 1. **Most Comprehensive** - 33 tools covering every development need 2. **Production Ready** - Enterprise-grade security and error handling 3. **Well Documented** - Clear examples and comprehensive docs 4. **Actively Maintained** - Regular updates and improvements 5. **Community Driven** - Built based on real user needs 6. **Cross-Platform** - Works on Windows, macOS, and Linux 7. **Type Safe** - Full TypeScript implementation 8. **Tested** - Comprehensive test coverage 9. **Secure** - Multiple layers of security protection 10. **Easy to Use** - Natural language interface through Claude --- ## 🎉 Get Started Now! Transform your Claude Desktop into the ultimate development environment: 1. Install the server 2. Restart Claude Desktop 3. Start using natural language commands 4. Accomplish anything! **Welcome to the ULTIMATE MCP experience!** 🚀