Version 1.8.0 - Token Optimization & Dependency Updates

🚀 Version 1.8.0 - Token Optimization & Dependency Updates

🎯 Major Features

📊 Token Usage Optimization

• NEW: Selective tool loading to dramatically reduce token consumption
• NEW: 6 predefined presets for common use cases
• NEW: Individual tool selection support
• Result: Up to 89% token reduction (from ~10.3k to ~1k tokens with BASIC preset) 🎉

⚙️ Configuration System

• NEW: ENABLED_TOOLS environment variable support
• NEW: --tools CLI parameter for direct configuration
• NEW: --help command with comprehensive documentation
• NEW: Automatic token usage estimation and reporting
• NEW: Tool configuration manager with validation and error handling

🎨 Available Presets

• ALL: All tools (~10.3k tokens) - default for compatibility
• BASIC: HTML + Markdown only (~1k tokens, 89% reduction) 📈
• WEB: Web content + screenshots (~1.5k tokens, 85% reduction)
• DEBUG: Web + debugging tools (~2.5k tokens, 76% reduction)
• PERFORMANCE: Performance analysis tools (~6k tokens, 42% reduction)
• FULL_ANALYSIS: All tools except performance test framework (~9k tokens)

🏗️ Architecture Improvements

• NEW: Lazy loading system for tool handlers
• NEW: Dynamic tool registration based on configuration
• NEW: Improved logging with tool configuration details
• NEW: Enhanced error handling for invalid tool configurations

📦 Dependency Updates

🔧 Major Updates

• Updated: @modelcontextprotocol/sdk from 1.0.4 → 1.17.4
  • Supports new Streamable HTTP transport (backward compatible)
  • Enhanced MCP protocol features
  • No breaking changes for stdio transport usage
• Updated: sharp from 0.33.2 → 0.34.3
  • Improved wide-character support
  • Enhanced alpha channel handling
  • Updated GIF output defaults

📝 Minor Updates

• Updated: chrome-launcher, lighthouse, turndown, dotenv to latest versions

📚 Documentation

📖 Comprehensive README Updates

• NEW: Quick Start section for immediate setup
• NEW: Complete token usage optimization guide
• NEW: Detailed preset comparison table
• NEW: Claude Desktop integration examples
• NEW: Claude Code integration with claude mcp add commands
• NEW: Team collaboration setup instructions

💡 Quick Start Examples

Claude Desktop (Token Optimized)

{
  "mcpServers": {
    "webtools": {
      "command": "npx",
      "args": ["-y", "@bschauer/webtools-mcp-server@1.8.0"],
      "env": {
        "ENABLED_TOOLS": "BASIC"
      }
    }
  }
}

Claude Code

claude mcp add webtools-basic --env ENABLED_TOOLS=BASIC -- npx -y @bschauer/webtools-mcp-server@1.8.0

🔄 Backward Compatibility

• 100% backward compatible - all existing configurations continue to work ✅
• Default behavior unchanged (all tools loaded) unless explicitly configured
• Existing Claude Desktop and Claude Code integrations unaffected

🎉 Impact Summary

• Token Efficiency: Up to 89% reduction in token usage
• User Choice: 6 presets + individual tool selection
• Developer Friendly: Comprehensive documentation and examples
• Production Ready: Extensive testing and backward compatibility
• Future Proof: Updated dependencies and modern architecture